@unbrained/pm-cli 2026.9.6 → 2026.9.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/skills/pm-developer/SKILL.md +12 -4
- package/.agents/skills/pm-developer/references/MULTI_AGENT_MERGE.md +19 -10
- package/.agents/skills/pm-extensions/SKILL.md +6 -0
- package/.agents/skills/pm-sdk/SKILL.md +11 -2
- package/.agents/skills/pm-user/SKILL.md +5 -0
- package/.agents/skills/pm-user/references/ECOSYSTEM_PLANNING.md +95 -0
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +218 -182
- package/dist/cli/after-command-context-usage.js +1 -48
- package/dist/cli/argv-utils.js +1 -40
- package/dist/cli/bootstrap-args.js +1 -9
- package/dist/cli/bundle-integrity.js +2 -110
- package/dist/cli/commander-usage.js +11 -771
- package/dist/cli/commands/activity.js +1 -9
- package/dist/cli/commands/aggregate.js +1 -5
- package/dist/cli/commands/append.js +1 -5
- package/dist/cli/commands/claim.js +1 -5
- package/dist/cli/commands/close-many.js +1 -5
- package/dist/cli/commands/close.js +1 -9
- package/dist/cli/commands/comments.js +1 -5
- package/dist/cli/commands/config.js +1 -9
- package/dist/cli/commands/context.js +1 -9
- package/dist/cli/commands/contracts.js +1 -5
- package/dist/cli/commands/copy.js +1 -9
- package/dist/cli/commands/create.js +1 -9
- package/dist/cli/commands/delete.js +1 -9
- package/dist/cli/commands/deps.js +1 -9
- package/dist/cli/commands/docs.js +1 -9
- package/dist/cli/commands/duplicates.js +1 -9
- package/dist/cli/commands/eval.js +1 -9
- package/dist/cli/commands/extension/describe.js +1 -5
- package/dist/cli/commands/extension/scaffold.js +1 -5
- package/dist/cli/commands/extension/shared.js +1 -5
- package/dist/cli/commands/extension.js +1 -9
- package/dist/cli/commands/files.js +1 -9
- package/dist/cli/commands/focus.js +1 -9
- package/dist/cli/commands/gc.js +1 -9
- package/dist/cli/commands/get.js +1 -9
- package/dist/cli/commands/graph.js +1 -10
- package/dist/cli/commands/health.js +1 -9
- package/dist/cli/commands/history-compact.js +1 -10
- package/dist/cli/commands/history-redact.js +1 -11
- package/dist/cli/commands/history-repair.js +1 -10
- package/dist/cli/commands/history.js +1 -5
- package/dist/cli/commands/index.js +1 -58
- package/dist/cli/commands/init-agent-guidance.js +1 -9
- package/dist/cli/commands/init.js +1 -9
- package/dist/cli/commands/learnings.js +1 -5
- package/dist/cli/commands/lifecycle-transitions.js +1 -5
- package/dist/cli/commands/list.js +1 -9
- package/dist/cli/commands/merge.js +1 -11
- package/dist/cli/commands/next.js +1 -9
- package/dist/cli/commands/notes.js +1 -5
- package/dist/cli/commands/plan.js +1 -9
- package/dist/cli/commands/profile.js +1 -9
- package/dist/cli/commands/restore.js +1 -9
- package/dist/cli/commands/scheduling-shortcuts.js +1 -9
- package/dist/cli/commands/schema.js +1 -10
- package/dist/cli/commands/search.js +1 -9
- package/dist/cli/commands/stats.js +1 -9
- package/dist/cli/commands/telemetry.js +1 -9
- package/dist/cli/commands/test-all.js +1 -9
- package/dist/cli/commands/test-runs.js +1 -9
- package/dist/cli/commands/test.js +1 -9
- package/dist/cli/commands/update-many.js +1 -5
- package/dist/cli/commands/update.js +1 -9
- package/dist/cli/commands/upgrade.js +1 -5
- package/dist/cli/commands/validate.js +1 -15
- package/dist/cli/context-intent-invocation.js +1 -20
- package/dist/cli/description-stdin.js +1 -17
- package/dist/cli/error-guidance.js +1 -1353
- package/dist/cli/extension-command-help.js +5 -636
- package/dist/cli/extension-command-options.js +1 -427
- package/dist/cli/extension-recovery.js +1 -126
- package/dist/cli/help-content.js +2 -1001
- package/dist/cli/help-json-payload.js +4 -570
- package/dist/cli/main.d.ts +4 -0
- package/dist/cli/main.js +5 -2573
- package/dist/cli/migration-gates.js +1 -289
- package/dist/cli/public.js +1 -20
- package/dist/cli/register-annotations.js +1 -270
- package/dist/cli/register-assurance.js +1 -62
- package/dist/cli/register-files-lookup.js +1 -56
- package/dist/cli/register-history-activity.d.ts +8 -0
- package/dist/cli/register-history-activity.js +2 -0
- package/dist/cli/register-history-author.js +1 -38
- package/dist/cli/register-history-maintenance.d.ts +9 -0
- package/dist/cli/register-history-maintenance.js +2 -0
- package/dist/cli/register-list-query.js +10 -943
- package/dist/cli/register-mutation-options.js +1 -9
- package/dist/cli/register-mutation.js +19 -1893
- package/dist/cli/register-operations.js +1 -920
- package/dist/cli/register-setup.js +1 -716
- package/dist/cli/register-structured-mutation.js +1 -196
- package/dist/cli/registration-helpers.js +1 -5
- package/dist/cli/runtime-compatibility-boundary.js +4 -42
- package/dist/cli/schema-registration-helpers.js +1 -73
- package/dist/cli/search-refresh.js +1 -13
- package/dist/cli/stats-analytics-json.js +1 -68
- package/dist/cli/telemetry-flush.js +1 -10
- package/dist/cli-bundle/bundle-manifest.json +164 -156
- package/dist/cli-bundle/chunks/chunk-3BZZA6A3.js +5 -0
- package/dist/cli-bundle/chunks/chunk-AMRDVX36.js +235 -0
- package/dist/cli-bundle/chunks/chunk-DAM4CBBR.js +2202 -0
- package/dist/cli-bundle/chunks/{chunk-WYRZZ5ZE.js → chunk-DEZPZOQ7.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-FLDWYEND.js +77 -0
- package/dist/cli-bundle/chunks/{chunk-NPN5I67J.js → chunk-G5ADGQ2D.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-JAAEYHUA.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-JX4DH4WC.js → chunk-KR3RP4FH.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-LEZOUXG6.js +2 -0
- package/dist/cli-bundle/chunks/chunk-NSAPNEYH.js +2 -0
- package/dist/cli-bundle/chunks/chunk-QOEKOECV.js +29 -0
- package/dist/cli-bundle/chunks/chunk-RHSFOMHU.js +2 -0
- package/dist/cli-bundle/chunks/chunk-XOD2PCB6.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-JT6XF6GE.js → chunk-YVEQ2AMO.js} +4 -4
- package/dist/cli-bundle/chunks/register-list-query-KSK3R63M.js +11 -0
- package/dist/cli-bundle/chunks/register-mutation-IQ5C7U6O.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-I5W3KMGB.js → register-operations-DWVHR2NC.js} +2 -2
- package/dist/cli-bundle/chunks/register-setup-BQ5SVD4B.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-3WRPWLA7.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-7MBUII7U.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-COPBO5HW.js +8 -0
- package/dist/cli-bundle/focused-chunks/chunk-DUN4IXYN.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-LIJIA4TY.js → chunk-EE5QSM4Z.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-HJVARYM3.js +6 -0
- package/dist/cli-bundle/focused-chunks/chunk-IAUOUGVR.js +177 -0
- package/dist/cli-bundle/focused-chunks/chunk-KOOMJ54F.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-MZDXX7JY.js +56 -0
- package/dist/cli-bundle/focused-chunks/{chunk-M6PBRFSH.js → chunk-OPFHFGDD.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-QHNETP77.js +9 -0
- package/dist/cli-bundle/focused-chunks/{chunk-3BZEOXLT.js → chunk-RMWES4M6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-RXT4P5QH.js +10 -0
- package/dist/cli-bundle/focused-chunks/chunk-SDOL6FM2.js +12 -0
- package/dist/cli-bundle/focused-chunks/chunk-SQV4AAUC.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-PEFABF7E.js → chunk-WE3IUNIW.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-YALOUBWJ.js +2 -0
- package/dist/cli-bundle/main.js +20 -20
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +29 -29
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +42 -42
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +11 -11
- package/dist/cli.js +1 -104
- package/dist/core/checkpoint/checkpoint-gc.js +1 -169
- package/dist/core/checkpoint/mutation-checkpoint.js +2 -133
- package/dist/core/config/nested-settings.js +1 -534
- package/dist/core/config/positional-value.js +1 -109
- package/dist/core/diagnostics/remediation.js +1 -506
- package/dist/core/extensions/activation-summary-markdown.js +2 -145
- package/dist/core/extensions/activation-summary.js +1 -92
- package/dist/core/extensions/activation-transaction.js +1 -46
- package/dist/core/extensions/capability-usage.js +1 -173
- package/dist/core/extensions/command-hook-context.js +1 -13
- package/dist/core/extensions/command-metadata-contract.js +1 -22
- package/dist/core/extensions/command-visibility-tier.js +1 -29
- package/dist/core/extensions/contribution-inventory.js +1 -173
- package/dist/core/extensions/exporter-output-contract.js +1 -66
- package/dist/core/extensions/extension-candidate.js +1 -18
- package/dist/core/extensions/extension-capability-aliases.js +1 -158
- package/dist/core/extensions/extension-hook-runtime.js +1 -699
- package/dist/core/extensions/extension-policy.js +1 -599
- package/dist/core/extensions/extension-registries.js +1 -62
- package/dist/core/extensions/extension-runtime-helpers.js +1 -33
- package/dist/core/extensions/extension-types.js +1 -102
- package/dist/core/extensions/flag-definition-validation.js +1 -52
- package/dist/core/extensions/flag-value-types.js +1 -64
- package/dist/core/extensions/index.js +1 -526
- package/dist/core/extensions/item-field-types.js +1 -39
- package/dist/core/extensions/item-fields.js +1 -261
- package/dist/core/extensions/loader.js +1 -2223
- package/dist/core/extensions/manifest-schema.js +1 -69
- package/dist/core/extensions/module-graph-snapshot.js +1 -33
- package/dist/core/extensions/preflight-ownership.js +1 -41
- package/dist/core/extensions/registration-validation.js +1 -82
- package/dist/core/extensions/registration-values.js +1 -209
- package/dist/core/extensions/reserved-host-flags.js +1 -36
- package/dist/core/extensions/runtime-registrations.js +1 -67
- package/dist/core/extensions/service-ownership.js +1 -19
- package/dist/core/extensions/version-compat.js +1 -216
- package/dist/core/fs/fs-utils.js +2 -158
- package/dist/core/fs/host-environment-errors.js +1 -141
- package/dist/core/fs/index.js +1 -9
- package/dist/core/fs/path-utils.js +1 -17
- package/dist/core/governance/content-fields.js +1 -160
- package/dist/core/governance/issue-codes.js +1 -151
- package/dist/core/governance/metadata-coverage.js +1 -358
- package/dist/core/history/drift-cache.js +3 -72
- package/dist/core/history/drift-scan.js +1 -342
- package/dist/core/history/event-classification.js +1 -109
- package/dist/core/history/event-index.js +8 -784
- package/dist/core/history/history-compact-bulk.js +1 -104
- package/dist/core/history/history-diff.js +1 -158
- package/dist/core/history/history-rewrite.d.ts +6 -1
- package/dist/core/history/history-rewrite.js +1 -107
- package/dist/core/history/history-storage-stats.js +1 -102
- package/dist/core/history/history-stream-policy.js +1 -62
- package/dist/core/history/history.js +2 -617
- package/dist/core/history/identity.js +1 -30
- package/dist/core/history/index.js +1 -9
- package/dist/core/history/projection.js +1 -196
- package/dist/core/history/read.d.ts +9 -0
- package/dist/core/history/read.js +1 -57
- package/dist/core/history/replay.js +2 -439
- package/dist/core/history/version-address.js +1 -32
- package/dist/core/history/workspace-history.js +2 -433
- package/dist/core/io/body-file.js +1 -62
- package/dist/core/io/bulk-ids-input.js +1 -112
- package/dist/core/item/actionability.js +1 -327
- package/dist/core/item/dependency-reference.js +1 -20
- package/dist/core/item/id.js +1 -112
- package/dist/core/item/index.js +1 -12
- package/dist/core/item/item-format-version.js +1 -78
- package/dist/core/item/item-format.js +5 -1473
- package/dist/core/item/item-record.js +1 -23
- package/dist/core/item/item-type-definition.js +1 -133
- package/dist/core/item/parent-reference-policy.js +1 -57
- package/dist/core/item/parse.js +2 -603
- package/dist/core/item/plan-lifecycle.js +1 -19
- package/dist/core/item/priority.js +1 -61
- package/dist/core/item/sprint-release-format.js +1 -38
- package/dist/core/item/status-filter.js +1 -115
- package/dist/core/item/status.js +1 -43
- package/dist/core/item/toon-decode.js +1 -29
- package/dist/core/item/type-registry.js +1 -715
- package/dist/core/item/type-synonyms.js +1 -38
- package/dist/core/lock/index.js +1 -9
- package/dist/core/lock/lock-gc.js +1 -240
- package/dist/core/lock/lock.js +3 -590
- package/dist/core/output/mutation-projection.js +1 -217
- package/dist/core/output/output-control.js +1 -25
- package/dist/core/output/output.js +11 -494
- package/dist/core/output/query-summary.js +1 -58
- package/dist/core/output/tabular.js +1 -77
- package/dist/core/packages/manifest.js +1 -244
- package/dist/core/packages/root.js +1 -84
- package/dist/core/profile/profile-describe.js +1 -83
- package/dist/core/profile/profile-lint.js +1 -415
- package/dist/core/profile/profile-plan.js +0 -0
- package/dist/core/profile/profile-presets.js +1 -370
- package/dist/core/reproducibility/context.js +1 -82
- package/dist/core/schema/fields-file.js +2 -288
- package/dist/core/schema/item-types-file.js +2 -296
- package/dist/core/schema/runtime-field-filters.js +1 -49
- package/dist/core/schema/runtime-field-values.js +1 -313
- package/dist/core/schema/runtime-schema.js +2 -826
- package/dist/core/schema/status-defs-file.js +2 -227
- package/dist/core/schema/status-token.js +1 -31
- package/dist/core/schema/type-inference.js +1 -95
- package/dist/core/schema/type-presets.js +1 -87
- package/dist/core/schema/type-workflows.js +1 -104
- package/dist/core/search/background-refresh.js +2 -286
- package/dist/core/search/bm25.js +1 -146
- package/dist/core/search/cache.js +2 -534
- package/dist/core/search/corpus.js +1 -311
- package/dist/core/search/embedding-batches.js +1 -163
- package/dist/core/search/eval.js +1 -225
- package/dist/core/search/http-client.js +1 -75
- package/dist/core/search/providers.js +1 -242
- package/dist/core/search/relevance.js +1 -244
- package/dist/core/search/semantic-defaults.js +1 -199
- package/dist/core/search/staleness.js +1 -30
- package/dist/core/search/vector-stores.js +2 -664
- package/dist/core/search/vectorization-metadata.js +1 -81
- package/dist/core/sentry/helpers.js +1 -272
- package/dist/core/sentry/instrument.js +1 -387
- package/dist/core/session/session-state.js +1 -260
- package/dist/core/shared/agent-session-context.js +1 -133
- package/dist/core/shared/author.js +1 -1172
- package/dist/core/shared/command-types.js +1 -4
- package/dist/core/shared/conflict-markers.js +1 -31
- package/dist/core/shared/constants.js +1 -405
- package/dist/core/shared/errors.js +1 -20
- package/dist/core/shared/html-entity-decode.js +1 -131
- package/dist/core/shared/index.js +1 -12
- package/dist/core/shared/item-metadata-contract.js +1 -89
- package/dist/core/shared/lazy-module.js +1 -16
- package/dist/core/shared/levenshtein.js +1 -61
- package/dist/core/shared/memo.js +1 -19
- package/dist/core/shared/numeric-parsers.js +1 -20
- package/dist/core/shared/option-alias-visibility.js +1 -67
- package/dist/core/shared/primitives.js +1 -127
- package/dist/core/shared/serial-queue.js +1 -79
- package/dist/core/shared/serialization.js +1 -210
- package/dist/core/shared/split-comma-list.js +1 -30
- package/dist/core/shared/text-normalization.js +1 -38
- package/dist/core/shared/time.js +1 -306
- package/dist/core/store/index.js +1 -12
- package/dist/core/store/item-format-migration.js +1 -125
- package/dist/core/store/item-metadata-cache.js +1 -1116
- package/dist/core/store/item-metadata-query-index.js +9 -394
- package/dist/core/store/item-metadata-read-work.js +1 -43
- package/dist/core/store/item-store.js +1 -693
- package/dist/core/store/paths.d.ts +1 -1
- package/dist/core/store/paths.js +1 -214
- package/dist/core/store/settings-read-cache.js +1 -85
- package/dist/core/store/settings-validator.js +1 -421
- package/dist/core/store/settings.js +3 -1309
- package/dist/core/store/tracker-preflight.js +1 -141
- package/dist/core/telemetry/consent.js +5 -108
- package/dist/core/telemetry/observability.js +1 -246
- package/dist/core/telemetry/runtime.js +4 -1988
- package/dist/core/test/background-runs.js +4 -945
- package/dist/core/test/item-test-run-tracking.js +1 -63
- package/dist/core/test/run-selectors.js +1 -120
- package/dist/core/validate/estimate-defaults.js +1 -89
- package/dist/core/validate/fix-planning.js +1 -189
- package/dist/core/validate/linked-artifact-reference.js +1 -36
- package/dist/core/validate/missing-by-type.js +1 -34
- package/dist/core/validate/missing-link-owners.js +1 -95
- package/dist/core/validate/stale-file-classification.js +1 -82
- package/dist/mcp/http-server.js +5 -448
- package/dist/mcp/legacy-adapter.js +1 -77
- package/dist/mcp/runtime-capabilities.js +1 -200
- package/dist/mcp/server.js +4 -1233
- package/dist/mcp/tool-definitions.js +1 -804
- package/dist/sdk/actionability.js +1 -13
- package/dist/sdk/agent/closed-domain-contracts.js +1 -161
- package/dist/sdk/agent/command-recovery.js +1 -59
- package/dist/sdk/agent/command-suggestions.js +1 -66
- package/dist/sdk/agent/create-option-policy.js +1 -31
- package/dist/sdk/agent/identity-config.js +1 -106
- package/dist/sdk/agent/item-addressing.js +1 -207
- package/dist/sdk/agent/refusal-closure-census.js +1 -151
- package/dist/sdk/agent/refusal-closure.js +1 -133
- package/dist/sdk/agent/refusal-corpus-contracts.js +1 -193
- package/dist/sdk/agent/refusal-reachability.js +1 -593
- package/dist/sdk/agent/subcommand-recovery.js +1 -83
- package/dist/sdk/agent/task-transcript-contracts.js +1 -197
- package/dist/sdk/agent/tracker-preflight-contracts.js +1 -126
- package/dist/sdk/agent-capability-contracts.js +1 -428
- package/dist/sdk/agent-session-context.js +1 -9
- package/dist/sdk/annotations.js +1 -448
- package/dist/sdk/author-attribution.js +1 -468
- package/dist/sdk/authoring.js +1 -20
- package/dist/sdk/cli-bootstrap.js +1 -838
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts/agent-output-contracts.js +4 -476
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.js +1 -79
- package/dist/sdk/cli-contracts/command-aliases.d.ts +4 -0
- package/dist/sdk/cli-contracts/command-aliases.js +1 -107
- package/dist/sdk/cli-contracts/command-exit-contracts.js +1 -151
- package/dist/sdk/cli-contracts/commander-mutation-options.js +1 -1081
- package/dist/sdk/cli-contracts/commander-types.js +1 -159
- package/dist/sdk/cli-contracts/completeness.js +1 -393
- package/dist/sdk/cli-contracts/enum-contracts.js +1 -222
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1947
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -347
- package/dist/sdk/cli-contracts/grammar-contracts.js +1 -986
- package/dist/sdk/cli-contracts/registration-helpers.js +7 -990
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +5 -0
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -2090
- package/dist/sdk/cli-contracts/schemas/assurance-definition.js +1 -324
- package/dist/sdk/cli-contracts/string-lists.js +1 -16
- package/dist/sdk/cli-contracts/tool-option-contracts.js +1 -461
- package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -2167
- package/dist/sdk/cli-contracts/tool-schema.d.ts +3 -1
- package/dist/sdk/cli-contracts/tool-schema.js +1 -1664
- package/dist/sdk/cli-contracts/typed-action-inputs.js +1 -4
- package/dist/sdk/cli-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts.js +1 -17
- package/dist/sdk/cli-program.js +1 -49
- package/dist/sdk/command-line.d.ts +2 -5
- package/dist/sdk/command-line.js +1 -78
- package/dist/sdk/comments.js +1 -133
- package/dist/sdk/compile-cache.js +1 -73
- package/dist/sdk/completion.js +157 -837
- package/dist/sdk/compose.js +1 -1090
- package/dist/sdk/config.js +1 -1204
- package/dist/sdk/context/recency.js +1 -33
- package/dist/sdk/context/semantic-session-attribution.js +1 -82
- package/dist/sdk/context/usage-egress.js +1 -29
- package/dist/sdk/context/usage-ledger.js +3 -185
- package/dist/sdk/context-intent-contracts.js +1 -709
- package/dist/sdk/context-intent-runtime.js +1 -115
- package/dist/sdk/context-packing.js +1 -218
- package/dist/sdk/context-relevance.js +1 -503
- package/dist/sdk/context-signal-store.js +2 -426
- package/dist/sdk/context-usage.js +1 -367
- package/dist/sdk/contracts.js +1 -23
- package/dist/sdk/core-governance.js +1 -14
- package/dist/sdk/core.js +1 -14
- package/dist/sdk/corpus-shape.js +1 -401
- package/dist/sdk/define.js +1 -220
- package/dist/sdk/dependencies.js +1 -718
- package/dist/sdk/dependency-flag-validation.js +1 -156
- package/dist/sdk/dependency-provenance.js +1 -135
- package/dist/sdk/docs.js +1 -14
- package/dist/sdk/duplicates.js +1 -40
- package/dist/sdk/environment/agent-environment.js +1 -466
- package/dist/sdk/environment/host-environment-errors.js +1 -8
- package/dist/sdk/environment/project-runtime-compatibility.js +1 -481
- package/dist/sdk/environment/source-context.js +1 -28
- package/dist/sdk/environment/tracker-preflight.js +1 -9
- package/dist/sdk/error-code-catalog.js +1 -153
- package/dist/sdk/error-runtime.js +1 -58
- package/dist/sdk/errors.js +1 -58
- package/dist/sdk/eval.js +1 -190
- package/dist/sdk/extension/author-manifest.js +1 -92
- package/dist/sdk/extension/bundled-catalog.js +1 -332
- package/dist/sdk/extension/concurrency.js +1 -25
- package/dist/sdk/extension/copy-scope.d.ts +2 -0
- package/dist/sdk/extension/copy-scope.js +2 -0
- package/dist/sdk/extension/custom-field-collisions.js +1 -30
- package/dist/sdk/extension/describe.js +3 -189
- package/dist/sdk/extension/doctor.js +1 -606
- package/dist/sdk/extension/install-plan.d.ts +69 -0
- package/dist/sdk/extension/install-plan.js +2 -0
- package/dist/sdk/extension/install-receipts.d.ts +7 -0
- package/dist/sdk/extension/install-receipts.js +2 -0
- package/dist/sdk/extension/install-runtime.js +3 -313
- package/dist/sdk/extension/install-snapshot.js +1 -66
- package/dist/sdk/extension/install-sources.js +5 -1057
- package/dist/sdk/extension/managed-state.js +2 -252
- package/dist/sdk/extension/migrations.js +2 -174
- package/dist/sdk/extension/output-ownership.js +1 -25
- package/dist/sdk/extension/runtime-summary.js +1 -18
- package/dist/sdk/extension/scaffold.js +4 -2308
- package/dist/sdk/extension/shared.js +1 -147
- package/dist/sdk/extension/source-resolution.js +1 -65
- package/dist/sdk/extension/update-check.js +1 -67
- package/dist/sdk/extension-command-context.js +1 -44
- package/dist/sdk/extension-contracts.js +1 -73
- package/dist/sdk/extension.d.ts +7 -2
- package/dist/sdk/extension.js +1 -2196
- package/dist/sdk/files.js +1 -535
- package/dist/sdk/flag-invocation-contracts.d.ts +0 -5
- package/dist/sdk/flag-invocation-contracts.js +1 -344
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -2224
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -2236
- package/dist/sdk/generated-error-code-catalog.js +1 -16
- package/dist/sdk/governance/assurance-action-contracts.js +1 -4
- package/dist/sdk/governance/assurance-action.js +1 -411
- package/dist/sdk/governance/assurance-limits.js +1 -10
- package/dist/sdk/governance/assurance-mutation-error.js +1 -81
- package/dist/sdk/governance/assurance-presets.js +1 -135
- package/dist/sdk/governance/assurance-runtime.js +1 -238
- package/dist/sdk/governance/assurance.js +4 -1182
- package/dist/sdk/governance/boundary-fixtures.js +1 -200
- package/dist/sdk/governance/coverage-assurance.js +1 -60
- package/dist/sdk/governance/defect-recurrence-coverage.js +1 -188
- package/dist/sdk/governance/defect-recurrence-graph.js +1 -120
- package/dist/sdk/governance/defect-recurrence-signals.js +1 -24
- package/dist/sdk/governance/defect-recurrence.js +1 -623
- package/dist/sdk/governance/extension-host-version.js +1 -115
- package/dist/sdk/governance/gc.js +1 -368
- package/dist/sdk/governance/health.js +1 -2367
- package/dist/sdk/governance/hierarchy-validation.js +1 -108
- package/dist/sdk/governance/linked-file-report.js +1 -71
- package/dist/sdk/governance/merge-receipt-history.js +1 -206
- package/dist/sdk/governance/provenance-health.js +1 -282
- package/dist/sdk/governance/reindex.js +4 -761
- package/dist/sdk/governance/stale-work.js +1 -82
- package/dist/sdk/governance/status-role-diagnostics.js +1 -35
- package/dist/sdk/governance/storage-integrity.js +1 -280
- package/dist/sdk/governance/tracked-runtime-cache.js +1 -106
- package/dist/sdk/governance/upgrade.js +2 -327
- package/dist/sdk/governance/validate-history-drift.js +1 -81
- package/dist/sdk/governance/validate-item-reader.js +1 -17
- package/dist/sdk/governance/validate-normalization.js +1 -36
- package/dist/sdk/governance/validate.js +1 -2261
- package/dist/sdk/governance/workspace-position.js +1 -163
- package/dist/sdk/governance.d.ts +1 -0
- package/dist/sdk/governance.js +1 -31
- package/dist/sdk/graph/adapter.js +1 -181
- package/dist/sdk/graph/analytics.js +1 -474
- package/dist/sdk/graph/assembly.js +1 -377
- package/dist/sdk/graph/cache.js +1 -160
- package/dist/sdk/graph/centrality.js +1 -258
- package/dist/sdk/graph/conformance.js +1 -130
- package/dist/sdk/graph/deadline-scheduling.d.ts +90 -0
- package/dist/sdk/graph/deadline-scheduling.js +2 -0
- package/dist/sdk/graph/durable-cache.d.ts +1 -1
- package/dist/sdk/graph/durable-cache.js +1 -361
- package/dist/sdk/graph/governance-contracts.js +1 -34
- package/dist/sdk/graph/governance.d.ts +13 -1
- package/dist/sdk/graph/governance.js +1 -735
- package/dist/sdk/graph/hierarchy-integrity.js +1 -310
- package/dist/sdk/graph/index.d.ts +3 -2
- package/dist/sdk/graph/index.js +1 -26
- package/dist/sdk/graph/lifecycle-coverage.d.ts +32 -0
- package/dist/sdk/graph/lifecycle-coverage.js +2 -0
- package/dist/sdk/graph/mutation-advisory.js +1 -176
- package/dist/sdk/graph/remediation.js +1 -197
- package/dist/sdk/graph/run.d.ts +15 -1
- package/dist/sdk/graph/run.js +1 -768
- package/dist/sdk/graph/scheduling.js +1 -124
- package/dist/sdk/graph/traversal.js +1 -284
- package/dist/sdk/graph/workspace-relationship-kind-registry.js +1 -27
- package/dist/sdk/graph.js +1 -15
- package/dist/sdk/guide-topics.js +1 -707
- package/dist/sdk/guide.js +1 -279
- package/dist/sdk/history/maintenance.d.ts +71 -0
- package/dist/sdk/history/maintenance.js +2 -0
- package/dist/sdk/history/salvage.js +2 -247
- package/dist/sdk/history/subject.d.ts +19 -0
- package/dist/sdk/history/subject.js +2 -0
- package/dist/sdk/history-analytics.js +1 -282
- package/dist/sdk/history-compact.js +1 -527
- package/dist/sdk/history-mcp.js +1 -68
- package/dist/sdk/history-provenance.js +1 -182
- package/dist/sdk/history-read.js +1 -96
- package/dist/sdk/history-redact.d.ts +1 -14
- package/dist/sdk/history-redact.js +1 -643
- package/dist/sdk/history-repair.d.ts +5 -0
- package/dist/sdk/history-repair.js +1 -657
- package/dist/sdk/improvement-ledger-validation.js +1 -62
- package/dist/sdk/improvement-ledger.js +2 -257
- package/dist/sdk/index.d.ts +4 -0
- package/dist/sdk/index.js +1 -183
- package/dist/sdk/init-agent-guidance.js +2 -496
- package/dist/sdk/init.js +2 -820
- package/dist/sdk/invocation-author.js +1 -39
- package/dist/sdk/item-children.js +1 -90
- package/dist/sdk/item-metadata-index.js +1 -15
- package/dist/sdk/item-schedule.js +1 -27
- package/dist/sdk/item-transaction.js +1 -396
- package/dist/sdk/learnings.js +1 -29
- package/dist/sdk/lifecycle/append.js +2 -53
- package/dist/sdk/lifecycle/claim.d.ts +2 -0
- package/dist/sdk/lifecycle/claim.js +1 -242
- package/dist/sdk/lifecycle/close-many.js +1 -438
- package/dist/sdk/lifecycle/close.js +1 -468
- package/dist/sdk/lifecycle/copy.js +1 -212
- package/dist/sdk/lifecycle/create.js +1 -1949
- package/dist/sdk/lifecycle/delete.js +1 -45
- package/dist/sdk/lifecycle/event-validation-messages.js +1 -91
- package/dist/sdk/lifecycle/focus.js +1 -91
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -24
- package/dist/sdk/lifecycle/legacy-none-tokens.js +1 -149
- package/dist/sdk/lifecycle/lifecycle-transitions.js +1 -40
- package/dist/sdk/lifecycle/mcp-actions.d.ts +2 -0
- package/dist/sdk/lifecycle/mcp-actions.js +1 -51
- package/dist/sdk/lifecycle/metadata-normalizers.js +1 -46
- package/dist/sdk/lifecycle/mutation-command-options.js +1 -9
- package/dist/sdk/lifecycle/plan.js +1 -1606
- package/dist/sdk/lifecycle/recurrence-parsers.js +1 -147
- package/dist/sdk/lifecycle/reopen.js +1 -68
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.js +1 -143
- package/dist/sdk/lifecycle/restore.d.ts +1 -0
- package/dist/sdk/lifecycle/restore.js +1 -330
- package/dist/sdk/lifecycle/shared-unset-fields.js +1 -295
- package/dist/sdk/lifecycle/update-many.js +1 -861
- package/dist/sdk/lifecycle/update.js +1 -2136
- package/dist/sdk/lifecycle-completion.js +1 -92
- package/dist/sdk/lifecycle-policy.js +1 -120
- package/dist/sdk/linked-artifacts.js +1 -530
- package/dist/sdk/mcp/apps.js +4 -133
- package/dist/sdk/mcp/authorization.js +1 -404
- package/dist/sdk/mcp/discovery.js +1 -494
- package/dist/sdk/mcp/interactions.js +1 -336
- package/dist/sdk/mcp/protocol.d.ts +7 -0
- package/dist/sdk/mcp/protocol.js +1 -184
- package/dist/sdk/mcp/skills.js +1 -389
- package/dist/sdk/mcp/subscriptions.js +1 -211
- package/dist/sdk/mcp/tasks.js +2 -430
- package/dist/sdk/mcp/transport.js +1 -260
- package/dist/sdk/merge/abandoned-receipts.js +1 -46
- package/dist/sdk/merge/driver.js +1 -212
- package/dist/sdk/merge/index.js +1 -16
- package/dist/sdk/merge/install.js +3 -561
- package/dist/sdk/merge/receipt-file-boundary.js +1 -46
- package/dist/sdk/merge/receipt-operation.js +1 -96
- package/dist/sdk/merge/receipt-schema.js +1 -397
- package/dist/sdk/merge/receipts.js +4 -525
- package/dist/sdk/merge/reconcile.js +1 -352
- package/dist/sdk/merge/three-way.js +3 -775
- package/dist/sdk/merge.js +1 -10
- package/dist/sdk/mutation-events.js +1 -292
- package/dist/sdk/mutation-guard.js +1 -216
- package/dist/sdk/notes.js +1 -139
- package/dist/sdk/output-contracts.js +1 -172
- package/dist/sdk/output-projection.js +1 -430
- package/dist/sdk/output-token-accounting.js +1 -140
- package/dist/sdk/output.js +1 -64
- package/dist/sdk/ownership-source.js +1 -21
- package/dist/sdk/package-import-adapters.js +1 -442
- package/dist/sdk/package-migrations.js +1 -20
- package/dist/sdk/package-runtime-options.js +1 -80
- package/dist/sdk/pagination.js +1 -162
- package/dist/sdk/profile.js +1 -454
- package/dist/sdk/provenance.js +1 -258
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.js +1 -401
- package/dist/sdk/query/aggregate.d.ts +16 -0
- package/dist/sdk/query/aggregate.js +1 -390
- package/dist/sdk/query/calendar.js +1 -964
- package/dist/sdk/query/complete-list.js +1 -215
- package/dist/sdk/query/context.js +1 -1702
- package/dist/sdk/query/duplicate-candidates.js +1 -70
- package/dist/sdk/query/get.js +1 -450
- package/dist/sdk/query/history.js +1 -186
- package/dist/sdk/query/item-filter-options.js +1 -9
- package/dist/sdk/query/light-metadata.js +1 -18
- package/dist/sdk/query/list-filter-shared.js +1 -81
- package/dist/sdk/query/list.js +1 -1304
- package/dist/sdk/query/multi-value-filters.js +1 -78
- package/dist/sdk/query/next.js +1 -513
- package/dist/sdk/query/parsers.js +1 -44
- package/dist/sdk/query/projection-contracts.js +1 -184
- package/dist/sdk/query/search-contracts.js +1 -230
- package/dist/sdk/query/search-pagination.js +1 -35
- package/dist/sdk/query/search-rendering.js +1 -105
- package/dist/sdk/query/search.js +2 -1987
- package/dist/sdk/query.js +1 -35
- package/dist/sdk/read-output/continuation.js +1 -194
- package/dist/sdk/read-output-budget.js +1 -135
- package/dist/sdk/read-output-contracts.js +1 -1225
- package/dist/sdk/read-output-rows.js +1 -186
- package/dist/sdk/read-output-session.js +1 -208
- package/dist/sdk/relationship-analytics.js +1 -410
- package/dist/sdk/relationship-context.js +1 -284
- package/dist/sdk/relationship-history.js +4 -519
- package/dist/sdk/relationship-kinds/contract.js +1 -22
- package/dist/sdk/relationship-migration.js +1 -77
- package/dist/sdk/relationships.js +1 -579
- package/dist/sdk/reproducibility/process.js +1 -87
- package/dist/sdk/runtime-action-aliases.js +1 -59
- package/dist/sdk/runtime-extended-actions.js +1 -177
- package/dist/sdk/runtime-input.js +1 -614
- package/dist/sdk/runtime-primitives.js +1 -84
- package/dist/sdk/runtime-public-contracts.js +1 -4
- package/dist/sdk/runtime-stats-options.js +1 -38
- package/dist/sdk/runtime.js +1 -1928
- package/dist/sdk/scheduling-shortcuts.js +1 -63
- package/dist/sdk/schema-migration.js +3 -856
- package/dist/sdk/schema.js +1 -1376
- package/dist/sdk/search-refresh-worker.js +1 -18
- package/dist/sdk/similarity-scoring.js +1 -53
- package/dist/sdk/similarity.js +1 -326
- package/dist/sdk/start-task-status.js +1 -14
- package/dist/sdk/stats.js +1 -270
- package/dist/sdk/structured-mutations.js +1 -580
- package/dist/sdk/telemetry-flush.js +1 -13
- package/dist/sdk/telemetry.js +1 -405
- package/dist/sdk/templates.js +2 -292
- package/dist/sdk/test/batch.js +2 -509
- package/dist/sdk/test/entry.js +1 -70
- package/dist/sdk/test/execution.js +6 -2211
- package/dist/sdk/test/linked-command-detection.js +1 -546
- package/dist/sdk/test/measurements.js +1 -91
- package/dist/sdk/test/parsers.js +1 -545
- package/dist/sdk/test/runs.js +1 -193
- package/dist/sdk/test/trust.js +2 -206
- package/dist/sdk/testing.js +4 -1391
- package/dist/sdk/traceability/runtime-files-lookup.js +1 -32
- package/dist/sdk/traceability/source-traceability.js +1 -292
- package/dist/sdk/tracker-root-discovery.js +1 -9
- package/dist/sdk/workspace-contracts-cache.js +1 -28
- package/dist/sdk/workspace-contracts.js +1 -33
- package/dist/sdk/workspace-memory.js +2 -318
- package/dist/sdk/workspace-recipe.js +1 -71
- package/dist/sdk/workspace-snapshot.js +4 -613
- package/dist/sdk/workspace-transaction-gc.js +1 -149
- package/dist/sdk/workspace-transaction.js +2 -363
- package/dist/sdk/workspace.js +3 -127
- package/dist/types/index.js +1 -9
- package/dist/types.js +1 -245
- package/docs/AGENT_GUIDE.md +1 -1
- package/docs/CONTEXT_ALGORITHM_PORTFOLIO.md +167 -0
- package/docs/DIAGNOSTIC_OUTPUT_CONTRACTS.md +9 -3
- package/docs/EXTENSIONS.md +1 -0
- package/docs/HISTORY_MAINTENANCE.md +125 -0
- package/docs/MCP_2026_07_28_CONFORMANCE.md +20 -10
- package/docs/PACKAGE_EVIDENCE.md +92 -0
- package/docs/PLANNING_MEASUREMENTS.md +183 -0
- package/docs/README.md +3 -0
- package/docs/RELEASING.md +1 -0
- package/docs/SCRIPTING.md +21 -0
- package/docs/TESTING.md +23 -0
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +5 -5
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +2 -2
- package/marketplace.json +2 -2
- package/package.json +1 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/scripts/finalize-build.mjs +45 -3
- package/dist/cli-bundle/chunks/chunk-AZDFJGH6.js +0 -9
- package/dist/cli-bundle/chunks/chunk-BAX2BYUW.js +0 -2111
- package/dist/cli-bundle/chunks/chunk-CKOL5U7J.js +0 -77
- package/dist/cli-bundle/chunks/chunk-OF76PSDQ.js +0 -5
- package/dist/cli-bundle/chunks/chunk-QUWFABDM.js +0 -232
- package/dist/cli-bundle/chunks/chunk-QWRRFYK3.js +0 -2
- package/dist/cli-bundle/chunks/chunk-RWWBOWJ5.js +0 -2
- package/dist/cli-bundle/chunks/chunk-WGAOYSYH.js +0 -40
- package/dist/cli-bundle/chunks/chunk-WI2AYPA7.js +0 -2
- package/dist/cli-bundle/chunks/register-list-query-5JL52D33.js +0 -11
- package/dist/cli-bundle/chunks/register-mutation-ZPG7KMVP.js +0 -20
- package/dist/cli-bundle/chunks/register-setup-H4SVAVX7.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-AL5ON6K6.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-CHC2IDXA.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-CK6QFAPZ.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-EZR3GHFE.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-H2WJWK7L.js +0 -56
- package/dist/cli-bundle/focused-chunks/chunk-NTPY5GSO.js +0 -3
- package/dist/cli-bundle/focused-chunks/chunk-P5O7MP5Y.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDMW2E36.js +0 -177
- package/dist/cli-bundle/focused-chunks/chunk-QTVCLMSZ.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-QTZRBUYA.js +0 -8
- package/dist/cli-bundle/focused-chunks/chunk-SGQST3PQ.js +0 -12
- package/dist/cli-bundle/focused-chunks/chunk-UKHASMMP.js +0 -10
- package/dist/cli-bundle/focused-chunks/chunk-ZPEKQHOC.js +0 -2
|
@@ -1,411 +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]="3167c288-0bcc-5a66-8aa0-ca5876ed7d36")}catch(e){}}();
|
|
3
|
-
import { createQueryFingerprint, decodeQueryCursor, encodeQueryCursor, } from "./pagination.js";
|
|
4
|
-
import { createRelationshipKindRegistry, } from "./relationships.js";
|
|
5
|
-
function visitImpactNeighbor(state, id, parent, root, after, limit) {
|
|
6
|
-
if (state.seen.has(id))
|
|
7
|
-
return "skip";
|
|
8
|
-
if (state.cursorFound && state.affected.length >= limit)
|
|
9
|
-
return "truncate";
|
|
10
|
-
state.seen.add(id);
|
|
11
|
-
state.parents.set(id, parent.id);
|
|
12
|
-
const depth = parent.depth + 1;
|
|
13
|
-
state.queue.push({ id, depth });
|
|
14
|
-
if (!state.cursorFound) {
|
|
15
|
-
state.cursorFound = id === after;
|
|
16
|
-
return "skip";
|
|
17
|
-
}
|
|
18
|
-
state.affected.push({
|
|
19
|
-
id,
|
|
20
|
-
distance: depth,
|
|
21
|
-
path: reconstructImpactPath(root, id, state.parents),
|
|
22
|
-
});
|
|
23
|
-
return "continue";
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Bind a continuation cursor to traversal semantics while allowing callers to
|
|
27
|
-
* choose a different page size when they resume.
|
|
28
|
-
*/
|
|
29
|
-
function resolveImpactCursor(root, options, direction, maxDepth) {
|
|
30
|
-
const fingerprint = createQueryFingerprint("graph impact", {
|
|
31
|
-
root,
|
|
32
|
-
direction,
|
|
33
|
-
kinds: [...(options.kinds ?? [])].sort(),
|
|
34
|
-
max_depth: Number.isFinite(maxDepth) ? maxDepth : "unbounded",
|
|
35
|
-
});
|
|
36
|
-
return {
|
|
37
|
-
fingerprint,
|
|
38
|
-
after: options.after === undefined
|
|
39
|
-
? undefined
|
|
40
|
-
: decodeQueryCursor(options.after, fingerprint),
|
|
41
|
-
};
|
|
42
|
-
}
|
|
43
|
-
function appendNeighbor(adjacency, source, target) {
|
|
44
|
-
adjacency.get(source).add(target);
|
|
45
|
-
}
|
|
46
|
-
function createAdjacency(nodes) {
|
|
47
|
-
return new Map(nodes.map((node) => [node, new Set()]));
|
|
48
|
-
}
|
|
49
|
-
function sortComponents(components) {
|
|
50
|
-
for (const component of components)
|
|
51
|
-
component.sort();
|
|
52
|
-
return components.sort((left, right) => right.length - left.length || left[0].localeCompare(right[0]));
|
|
53
|
-
}
|
|
54
|
-
function stableJsonValue(value) {
|
|
55
|
-
if (Array.isArray(value))
|
|
56
|
-
return value.map((entry) => stableJsonValue(entry));
|
|
57
|
-
if (value === null || typeof value !== "object")
|
|
58
|
-
return value;
|
|
59
|
-
const toJSON = value.toJSON;
|
|
60
|
-
if (typeof toJSON === "function")
|
|
61
|
-
return stableJsonValue(toJSON.call(value));
|
|
62
|
-
return Object.fromEntries(Object.entries(value)
|
|
63
|
-
.sort(([left], [right]) => left.localeCompare(right))
|
|
64
|
-
.map(([key, entry]) => [key, stableJsonValue(entry)]));
|
|
65
|
-
}
|
|
66
|
-
function relationshipEdgeKey(edge) {
|
|
67
|
-
return JSON.stringify(stableJsonValue(edge));
|
|
68
|
-
}
|
|
69
|
-
function appendFinishingOrder(start, adjacency, visited, order) {
|
|
70
|
-
const stack = [{ id: start, expanded: false }];
|
|
71
|
-
while (stack.length > 0) {
|
|
72
|
-
const current = stack.pop();
|
|
73
|
-
if (current.expanded) {
|
|
74
|
-
order.push(current.id);
|
|
75
|
-
continue;
|
|
76
|
-
}
|
|
77
|
-
if (visited.has(current.id))
|
|
78
|
-
continue;
|
|
79
|
-
visited.add(current.id);
|
|
80
|
-
stack.push({ id: current.id, expanded: true });
|
|
81
|
-
const neighbors = [...adjacency.get(current.id)].sort().reverse();
|
|
82
|
-
for (const neighbor of neighbors)
|
|
83
|
-
if (!visited.has(neighbor))
|
|
84
|
-
stack.push({ id: neighbor, expanded: false });
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
function computeFinishingOrder(nodes, adjacency) {
|
|
88
|
-
const visited = new Set();
|
|
89
|
-
const order = [];
|
|
90
|
-
for (const start of nodes)
|
|
91
|
-
if (!visited.has(start))
|
|
92
|
-
appendFinishingOrder(start, adjacency, visited, order);
|
|
93
|
-
return order;
|
|
94
|
-
}
|
|
95
|
-
function collectReverseComponents(order, reverse) {
|
|
96
|
-
const visited = new Set();
|
|
97
|
-
const components = [];
|
|
98
|
-
for (const start of [...order].reverse()) {
|
|
99
|
-
if (visited.has(start))
|
|
100
|
-
continue;
|
|
101
|
-
const component = [];
|
|
102
|
-
const stack = [start];
|
|
103
|
-
visited.add(start);
|
|
104
|
-
while (stack.length > 0) {
|
|
105
|
-
const current = stack.pop();
|
|
106
|
-
component.push(current);
|
|
107
|
-
for (const neighbor of reverse.get(current)) {
|
|
108
|
-
if (visited.has(neighbor))
|
|
109
|
-
continue;
|
|
110
|
-
visited.add(neighbor);
|
|
111
|
-
stack.push(neighbor);
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
components.push(component);
|
|
115
|
-
}
|
|
116
|
-
return sortComponents(components);
|
|
117
|
-
}
|
|
118
|
-
function stronglyConnectedComponents(nodes, adjacency) {
|
|
119
|
-
const reverse = createAdjacency(nodes);
|
|
120
|
-
for (const [source, targets] of adjacency)
|
|
121
|
-
for (const target of targets)
|
|
122
|
-
appendNeighbor(reverse, target, source);
|
|
123
|
-
return collectReverseComponents(computeFinishingOrder(nodes, adjacency), reverse);
|
|
124
|
-
}
|
|
125
|
-
function buildExecutionAdjacency(graph, registry) {
|
|
126
|
-
const adjacency = createAdjacency(graph.nodes());
|
|
127
|
-
for (const edge of graph.edges()) {
|
|
128
|
-
const definition = registry.require(edge.kind);
|
|
129
|
-
if (!definition.ordering)
|
|
130
|
-
continue;
|
|
131
|
-
// Legacy and JSON-parsed definitions may predate explicit precedence.
|
|
132
|
-
const sourceFirst = (definition.precedence ?? "source_before_target") ===
|
|
133
|
-
"source_before_target";
|
|
134
|
-
appendNeighbor(adjacency, sourceFirst ? edge.source : edge.target, sourceFirst ? edge.target : edge.source);
|
|
135
|
-
}
|
|
136
|
-
return adjacency;
|
|
137
|
-
}
|
|
138
|
-
function topologicalLayers(nodes, adjacency) {
|
|
139
|
-
const indegree = new Map(nodes.map((node) => [node, 0]));
|
|
140
|
-
for (const targets of adjacency.values())
|
|
141
|
-
for (const target of targets)
|
|
142
|
-
indegree.set(target, indegree.get(target) + 1);
|
|
143
|
-
let frontier = nodes.filter((node) => indegree.get(node) === 0).sort();
|
|
144
|
-
const layers = [];
|
|
145
|
-
while (frontier.length > 0) {
|
|
146
|
-
layers.push(frontier);
|
|
147
|
-
const next = [];
|
|
148
|
-
for (const source of frontier) {
|
|
149
|
-
for (const target of adjacency.get(source)) {
|
|
150
|
-
const remaining = indegree.get(target) - 1;
|
|
151
|
-
indegree.set(target, remaining);
|
|
152
|
-
if (remaining === 0)
|
|
153
|
-
next.push(target);
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
frontier = next.sort();
|
|
157
|
-
}
|
|
158
|
-
return layers;
|
|
159
|
-
}
|
|
160
|
-
function longestPath(order, adjacency) {
|
|
161
|
-
const depth = new Map(order.map((node) => [node, 0]));
|
|
162
|
-
const parent = new Map();
|
|
163
|
-
for (const source of order) {
|
|
164
|
-
for (const target of adjacency.get(source)) {
|
|
165
|
-
if (!depth.has(target))
|
|
166
|
-
continue;
|
|
167
|
-
const candidate = depth.get(source) + 1;
|
|
168
|
-
const currentParent = parent.get(target);
|
|
169
|
-
if (candidate > depth.get(target) ||
|
|
170
|
-
(candidate === depth.get(target) &&
|
|
171
|
-
(currentParent === undefined ||
|
|
172
|
-
source.localeCompare(currentParent) < 0))) {
|
|
173
|
-
depth.set(target, candidate);
|
|
174
|
-
parent.set(target, source);
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
}
|
|
178
|
-
const end = [...order].sort((left, right) => depth.get(right) - depth.get(left) || left.localeCompare(right))[0];
|
|
179
|
-
const path = end === undefined ? [] : [end];
|
|
180
|
-
while (path[0] !== undefined && parent.has(path[0]))
|
|
181
|
-
path.unshift(parent.get(path[0]));
|
|
182
|
-
return { depth: Object.fromEntries(depth), path };
|
|
183
|
-
}
|
|
184
|
-
function reconstructImpactPath(root, target, parents) {
|
|
185
|
-
const path = [target];
|
|
186
|
-
let cursor = target;
|
|
187
|
-
while (cursor !== root) {
|
|
188
|
-
cursor = parents.get(cursor);
|
|
189
|
-
path.push(cursor);
|
|
190
|
-
}
|
|
191
|
-
return path.reverse();
|
|
192
|
-
}
|
|
193
|
-
/** Analyze registered order-bearing relationships without treating associative cycles as blockers. */
|
|
194
|
-
export function analyzeRelationshipExecution(graph, options = {}) {
|
|
195
|
-
const registry = options.registry ?? createRelationshipKindRegistry();
|
|
196
|
-
const nodes = [...graph.nodes()];
|
|
197
|
-
const adjacency = buildExecutionAdjacency(graph, registry);
|
|
198
|
-
const layers = topologicalLayers(nodes, adjacency);
|
|
199
|
-
const order = layers.flat();
|
|
200
|
-
const acyclic = order.length === nodes.length;
|
|
201
|
-
const cycles = acyclic
|
|
202
|
-
? []
|
|
203
|
-
: stronglyConnectedComponents(nodes, adjacency).filter((component) => component.length > 1 ||
|
|
204
|
-
adjacency.get(component[0]).has(component[0]));
|
|
205
|
-
const longest = longestPath(order, adjacency);
|
|
206
|
-
return {
|
|
207
|
-
exact: true,
|
|
208
|
-
acyclic,
|
|
209
|
-
order,
|
|
210
|
-
layers,
|
|
211
|
-
frontier: layers[0] ?? [],
|
|
212
|
-
depth: longest.depth,
|
|
213
|
-
criticalPath: longest.path,
|
|
214
|
-
criticalPathLength: Math.max(0, longest.path.length - 1),
|
|
215
|
-
cycles,
|
|
216
|
-
provenance: { algorithm: "kahn-longest-path", edgeFamily: "ordering" },
|
|
217
|
-
};
|
|
218
|
-
}
|
|
219
|
-
/** Build impact-only adjacency from stored source-to-target orientation. */
|
|
220
|
-
function buildImpactAdjacency(graph, direction, kinds) {
|
|
221
|
-
const adjacency = createAdjacency(graph.nodes());
|
|
222
|
-
const selectedKinds = kinds === undefined
|
|
223
|
-
? undefined
|
|
224
|
-
: new Set(kinds.map((kind) => graph.registry().require(kind).kind));
|
|
225
|
-
const edges = graph.edges();
|
|
226
|
-
for (const edge of edges) {
|
|
227
|
-
const definition = graph.registry().require(edge.kind);
|
|
228
|
-
if (selectedKinds !== undefined &&
|
|
229
|
-
!selectedKinds.has(edge.kind) &&
|
|
230
|
-
(definition.inverse === undefined ||
|
|
231
|
-
!selectedKinds.has(definition.inverse))) {
|
|
232
|
-
continue;
|
|
233
|
-
}
|
|
234
|
-
appendNeighbor(adjacency, direction === "incoming" ? edge.target : edge.source, direction === "incoming" ? edge.source : edge.target);
|
|
235
|
-
}
|
|
236
|
-
return { adjacency, inspectedEdges: edges.length };
|
|
237
|
-
}
|
|
238
|
-
/** Combine complete direction-locked incoming and outgoing impact traversals. */
|
|
239
|
-
function analyzeBidirectionalGraphImpact(graph, root, options, after, limit, cursorFingerprint) {
|
|
240
|
-
const incoming = analyzeGraphImpact(graph, root, {
|
|
241
|
-
...options,
|
|
242
|
-
after: undefined,
|
|
243
|
-
direction: "incoming",
|
|
244
|
-
limit: undefined,
|
|
245
|
-
});
|
|
246
|
-
const outgoing = analyzeGraphImpact(graph, root, {
|
|
247
|
-
...options,
|
|
248
|
-
after: undefined,
|
|
249
|
-
direction: "outgoing",
|
|
250
|
-
limit: undefined,
|
|
251
|
-
});
|
|
252
|
-
const rows = new Map();
|
|
253
|
-
const candidates = [...incoming.affected, ...outgoing.affected].sort((left, right) => left.distance - right.distance ||
|
|
254
|
-
left.id.localeCompare(right.id) ||
|
|
255
|
-
left.path.join("\u0000").localeCompare(right.path.join("\u0000")));
|
|
256
|
-
for (const row of candidates) {
|
|
257
|
-
if (!rows.has(row.id)) {
|
|
258
|
-
rows.set(row.id, row);
|
|
259
|
-
}
|
|
260
|
-
}
|
|
261
|
-
const ordered = [...rows.values()].sort((left, right) => left.distance - right.distance || left.id.localeCompare(right.id));
|
|
262
|
-
const afterIndex = after === undefined || after === root
|
|
263
|
-
? -1
|
|
264
|
-
: ordered.findIndex((row) => row.id === after);
|
|
265
|
-
if (after !== undefined && after !== root && afterIndex < 0) {
|
|
266
|
-
throw new TypeError(`Unknown impact cursor item: ${after}`);
|
|
267
|
-
}
|
|
268
|
-
const affected = ordered.slice(afterIndex + 1, afterIndex + 1 + limit);
|
|
269
|
-
const rowLimitTruncated = afterIndex + 1 + affected.length < ordered.length;
|
|
270
|
-
return {
|
|
271
|
-
root,
|
|
272
|
-
affected,
|
|
273
|
-
exact: true,
|
|
274
|
-
truncated: incoming.truncated || outgoing.truncated || rowLimitTruncated,
|
|
275
|
-
...(rowLimitTruncated
|
|
276
|
-
? {
|
|
277
|
-
nextCursor: encodeQueryCursor(cursorFingerprint, affected.at(-1)?.id ?? root),
|
|
278
|
-
}
|
|
279
|
-
: {}),
|
|
280
|
-
cost: {
|
|
281
|
-
visitedNodes: incoming.cost.visitedNodes + outgoing.cost.visitedNodes,
|
|
282
|
-
inspectedEdges: incoming.cost.inspectedEdges + outgoing.cost.inspectedEdges,
|
|
283
|
-
},
|
|
284
|
-
};
|
|
285
|
-
}
|
|
286
|
-
/** Compute one stored-direction impact traversal and exact shortest explanation paths. */
|
|
287
|
-
function analyzeUnidirectionalGraphImpact(graph, root, options) {
|
|
288
|
-
const direction = options.direction;
|
|
289
|
-
const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;
|
|
290
|
-
const limit = options.limit ?? Number.POSITIVE_INFINITY;
|
|
291
|
-
const { fingerprint: cursorFingerprint, after } = resolveImpactCursor(root, options, direction, maxDepth);
|
|
292
|
-
const { adjacency, inspectedEdges } = buildImpactAdjacency(graph, direction, options.kinds);
|
|
293
|
-
const state = {
|
|
294
|
-
queue: [{ id: root, depth: 0 }],
|
|
295
|
-
seen: new Set([root]),
|
|
296
|
-
parents: new Map(),
|
|
297
|
-
affected: [],
|
|
298
|
-
cursorFound: after === undefined || after === root,
|
|
299
|
-
};
|
|
300
|
-
let visitedNodes = 0;
|
|
301
|
-
let truncated = false;
|
|
302
|
-
let rowLimitTruncated = false;
|
|
303
|
-
traversal: for (let index = 0; index < state.queue.length; index += 1) {
|
|
304
|
-
options.signal?.throwIfAborted();
|
|
305
|
-
const current = state.queue[index];
|
|
306
|
-
visitedNodes += 1;
|
|
307
|
-
const adjacent = [...adjacency.get(current.id)].sort();
|
|
308
|
-
if (current.depth >= maxDepth) {
|
|
309
|
-
if (adjacent.some((id) => !state.seen.has(id)))
|
|
310
|
-
truncated = true;
|
|
311
|
-
continue;
|
|
312
|
-
}
|
|
313
|
-
for (const id of adjacent) {
|
|
314
|
-
const outcome = visitImpactNeighbor(state, id, current, root, after, limit);
|
|
315
|
-
if (outcome === "truncate") {
|
|
316
|
-
truncated = true;
|
|
317
|
-
rowLimitTruncated = true;
|
|
318
|
-
break traversal;
|
|
319
|
-
}
|
|
320
|
-
}
|
|
321
|
-
}
|
|
322
|
-
if (!state.cursorFound) {
|
|
323
|
-
throw new TypeError(`Unknown impact cursor item: ${after}`);
|
|
324
|
-
}
|
|
325
|
-
return {
|
|
326
|
-
root,
|
|
327
|
-
affected: state.affected,
|
|
328
|
-
exact: true,
|
|
329
|
-
truncated,
|
|
330
|
-
...(rowLimitTruncated
|
|
331
|
-
? {
|
|
332
|
-
nextCursor: encodeQueryCursor(cursorFingerprint, state.affected.at(-1)?.id ?? root),
|
|
333
|
-
}
|
|
334
|
-
: {}),
|
|
335
|
-
cost: { visitedNodes, inspectedEdges },
|
|
336
|
-
};
|
|
337
|
-
}
|
|
338
|
-
/** Compute bounded impact rows and exact shortest explanation paths. */
|
|
339
|
-
export function analyzeGraphImpact(graph, root, options = {}) {
|
|
340
|
-
const direction = options.direction ?? "outgoing";
|
|
341
|
-
if (direction !== "both") {
|
|
342
|
-
return analyzeUnidirectionalGraphImpact(graph, root, {
|
|
343
|
-
...options,
|
|
344
|
-
direction,
|
|
345
|
-
});
|
|
346
|
-
}
|
|
347
|
-
const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;
|
|
348
|
-
const limit = options.limit ?? Number.POSITIVE_INFINITY;
|
|
349
|
-
const { fingerprint, after } = resolveImpactCursor(root, options, direction, maxDepth);
|
|
350
|
-
return analyzeBidirectionalGraphImpact(graph, root, options, after, limit, fingerprint);
|
|
351
|
-
}
|
|
352
|
-
/** Analyze weak/strong components, isolates, and exact unique-neighbor hubs. */
|
|
353
|
-
export function analyzeKnowledgeGraph(graph) {
|
|
354
|
-
const nodes = [...graph.nodes()];
|
|
355
|
-
const weak = createAdjacency(nodes);
|
|
356
|
-
const directed = createAdjacency(nodes);
|
|
357
|
-
for (const edge of graph.edges()) {
|
|
358
|
-
appendNeighbor(weak, edge.source, edge.target);
|
|
359
|
-
appendNeighbor(weak, edge.target, edge.source);
|
|
360
|
-
appendNeighbor(directed, edge.source, edge.target);
|
|
361
|
-
}
|
|
362
|
-
const components = [];
|
|
363
|
-
const visited = new Set();
|
|
364
|
-
for (const start of nodes) {
|
|
365
|
-
if (visited.has(start))
|
|
366
|
-
continue;
|
|
367
|
-
const component = [];
|
|
368
|
-
const stack = [start];
|
|
369
|
-
visited.add(start);
|
|
370
|
-
while (stack.length > 0) {
|
|
371
|
-
const current = stack.pop();
|
|
372
|
-
component.push(current);
|
|
373
|
-
for (const neighbor of weak.get(current)) {
|
|
374
|
-
if (visited.has(neighbor))
|
|
375
|
-
continue;
|
|
376
|
-
visited.add(neighbor);
|
|
377
|
-
stack.push(neighbor);
|
|
378
|
-
}
|
|
379
|
-
}
|
|
380
|
-
components.push(component);
|
|
381
|
-
}
|
|
382
|
-
const degrees = nodes.map((id) => ({ id, degree: weak.get(id).size }));
|
|
383
|
-
const maximum = Math.max(0, ...degrees.map(({ degree }) => degree));
|
|
384
|
-
return {
|
|
385
|
-
components: sortComponents(components),
|
|
386
|
-
stronglyConnected: stronglyConnectedComponents(nodes, directed),
|
|
387
|
-
orphans: degrees.filter(({ degree }) => degree === 0).map(({ id }) => id),
|
|
388
|
-
hubs: degrees.filter(({ degree }) => degree > 0 && degree === maximum),
|
|
389
|
-
exact: true,
|
|
390
|
-
provenance: { algorithm: "component-degree", edgeFamily: "all" },
|
|
391
|
-
};
|
|
392
|
-
}
|
|
393
|
-
/** Compare two immutable relationship snapshots by full normalized edge value. */
|
|
394
|
-
export function compareRelationshipSnapshots(before, after) {
|
|
395
|
-
const earlier = new Map(before.edges.map((edge) => [relationshipEdgeKey(edge), edge]));
|
|
396
|
-
const later = new Map(after.edges.map((edge) => [relationshipEdgeKey(edge), edge]));
|
|
397
|
-
return {
|
|
398
|
-
fromVersion: before.version,
|
|
399
|
-
toVersion: after.version,
|
|
400
|
-
added: [...later]
|
|
401
|
-
.filter(([key]) => !earlier.has(key))
|
|
402
|
-
.map(([, edge]) => edge),
|
|
403
|
-
removed: [...earlier]
|
|
404
|
-
.filter(([key]) => !later.has(key))
|
|
405
|
-
.map(([, edge]) => edge),
|
|
406
|
-
unchangedCount: [...earlier.keys()].filter((key) => later.has(key)).length,
|
|
407
|
-
exact: true,
|
|
408
|
-
};
|
|
409
|
-
}
|
|
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]="b3394526-5a20-5881-9a03-411ada32bd49")}catch(e2){}})();import{createQueryFingerprint,decodeQueryCursor,encodeQueryCursor}from"./pagination.js";import{createRelationshipKindRegistry}from"./relationships.js";function visitImpactNeighbor(state,id,parent,root,after,limit){if(state.seen.has(id))return"skip";if(state.cursorFound&&state.affected.length>=limit)return"truncate";state.seen.add(id);state.parents.set(id,parent.id);const depth=parent.depth+1;state.queue.push({id,depth});if(!state.cursorFound){state.cursorFound=id===after;return"skip"}state.affected.push({id,distance:depth,path:reconstructImpactPath(root,id,state.parents)});return"continue"}function resolveImpactCursor(root,options,direction,maxDepth){const fingerprint=createQueryFingerprint("graph impact",{root,direction,kinds:[...options.kinds??[]].sort(),max_depth:Number.isFinite(maxDepth)?maxDepth:"unbounded"});return{fingerprint,after:options.after===void 0?void 0:decodeQueryCursor(options.after,fingerprint)}}function appendNeighbor(adjacency,source,target){adjacency.get(source).add(target)}function createAdjacency(nodes){return new Map(nodes.map(node=>[node,new Set]))}function sortComponents(components){for(const component of components)component.sort();return components.sort((left,right)=>right.length-left.length||left[0].localeCompare(right[0]))}function stableJsonValue(value){if(Array.isArray(value))return value.map(entry=>stableJsonValue(entry));if(value===null||typeof value!=="object")return value;const toJSON=value.toJSON;if(typeof toJSON==="function")return stableJsonValue(toJSON.call(value));return Object.fromEntries(Object.entries(value).sort(([left],[right])=>left.localeCompare(right)).map(([key,entry])=>[key,stableJsonValue(entry)]))}function relationshipEdgeKey(edge){return JSON.stringify(stableJsonValue(edge))}function appendFinishingOrder(start,adjacency,visited,order){const stack=[{id:start,expanded:false}];while(stack.length>0){const current=stack.pop();if(current.expanded){order.push(current.id);continue}if(visited.has(current.id))continue;visited.add(current.id);stack.push({id:current.id,expanded:true});const neighbors=[...adjacency.get(current.id)].sort().reverse();for(const neighbor of neighbors)if(!visited.has(neighbor))stack.push({id:neighbor,expanded:false})}}function computeFinishingOrder(nodes,adjacency){const visited=new Set;const order=[];for(const start of nodes)if(!visited.has(start))appendFinishingOrder(start,adjacency,visited,order);return order}function collectReverseComponents(order,reverse){const visited=new Set;const components=[];for(const start of[...order].reverse()){if(visited.has(start))continue;const component=[];const stack=[start];visited.add(start);while(stack.length>0){const current=stack.pop();component.push(current);for(const neighbor of reverse.get(current)){if(visited.has(neighbor))continue;visited.add(neighbor);stack.push(neighbor)}}components.push(component)}return sortComponents(components)}function stronglyConnectedComponents(nodes,adjacency){const reverse=createAdjacency(nodes);for(const[source,targets]of adjacency)for(const target of targets)appendNeighbor(reverse,target,source);return collectReverseComponents(computeFinishingOrder(nodes,adjacency),reverse)}function buildExecutionAdjacency(graph,registry){const adjacency=createAdjacency(graph.nodes());for(const edge of graph.edges()){const definition=registry.require(edge.kind);if(!definition.ordering)continue;const sourceFirst=(definition.precedence??"source_before_target")==="source_before_target";appendNeighbor(adjacency,sourceFirst?edge.source:edge.target,sourceFirst?edge.target:edge.source)}return adjacency}function topologicalLayers(nodes,adjacency){const indegree=new Map(nodes.map(node=>[node,0]));for(const targets of adjacency.values())for(const target of targets)indegree.set(target,indegree.get(target)+1);let frontier=nodes.filter(node=>indegree.get(node)===0).sort();const layers=[];while(frontier.length>0){layers.push(frontier);const next=[];for(const source of frontier){for(const target of adjacency.get(source)){const remaining=indegree.get(target)-1;indegree.set(target,remaining);if(remaining===0)next.push(target)}}frontier=next.sort()}return layers}function longestPath(order,adjacency){const depth=new Map(order.map(node=>[node,0]));const parent=new Map;for(const source of order){for(const target of adjacency.get(source)){if(!depth.has(target))continue;const candidate=depth.get(source)+1;const currentParent=parent.get(target);if(candidate>depth.get(target)||candidate===depth.get(target)&&(currentParent===void 0||source.localeCompare(currentParent)<0)){depth.set(target,candidate);parent.set(target,source)}}}const end=[...order].sort((left,right)=>depth.get(right)-depth.get(left)||left.localeCompare(right))[0];const path=end===void 0?[]:[end];while(path[0]!==void 0&&parent.has(path[0]))path.unshift(parent.get(path[0]));return{depth:Object.fromEntries(depth),path}}function reconstructImpactPath(root,target,parents){const path=[target];let cursor=target;while(cursor!==root){cursor=parents.get(cursor);path.push(cursor)}return path.reverse()}function analyzeRelationshipExecution(graph,options={}){const registry=options.registry??createRelationshipKindRegistry();const nodes=[...graph.nodes()];const adjacency=buildExecutionAdjacency(graph,registry);const layers=topologicalLayers(nodes,adjacency);const order=layers.flat();const acyclic=order.length===nodes.length;const cycles=acyclic?[]:stronglyConnectedComponents(nodes,adjacency).filter(component=>component.length>1||adjacency.get(component[0]).has(component[0]));const longest=longestPath(order,adjacency);return{exact:true,acyclic,order,layers,frontier:layers[0]??[],depth:longest.depth,criticalPath:longest.path,criticalPathLength:Math.max(0,longest.path.length-1),cycles,provenance:{algorithm:"kahn-longest-path",edgeFamily:"ordering"}}}function buildImpactAdjacency(graph,direction,kinds){const adjacency=createAdjacency(graph.nodes());const selectedKinds=kinds===void 0?void 0:new Set(kinds.map(kind=>graph.registry().require(kind).kind));const edges=graph.edges();for(const edge of edges){const definition=graph.registry().require(edge.kind);if(selectedKinds!==void 0&&!selectedKinds.has(edge.kind)&&(definition.inverse===void 0||!selectedKinds.has(definition.inverse))){continue}appendNeighbor(adjacency,direction==="incoming"?edge.target:edge.source,direction==="incoming"?edge.source:edge.target)}return{adjacency,inspectedEdges:edges.length}}function analyzeBidirectionalGraphImpact(graph,root,options,after,limit,cursorFingerprint){const incoming=analyzeGraphImpact(graph,root,{...options,after:void 0,direction:"incoming",limit:void 0});const outgoing=analyzeGraphImpact(graph,root,{...options,after:void 0,direction:"outgoing",limit:void 0});const rows=new Map;const candidates=[...incoming.affected,...outgoing.affected].sort((left,right)=>left.distance-right.distance||left.id.localeCompare(right.id)||left.path.join("\0").localeCompare(right.path.join("\0")));for(const row of candidates){if(!rows.has(row.id)){rows.set(row.id,row)}}const ordered=[...rows.values()].sort((left,right)=>left.distance-right.distance||left.id.localeCompare(right.id));const afterIndex=after===void 0||after===root?-1:ordered.findIndex(row=>row.id===after);if(after!==void 0&&after!==root&&afterIndex<0){throw new TypeError(`Unknown impact cursor item: ${after}`)}const affected=ordered.slice(afterIndex+1,afterIndex+1+limit);const rowLimitTruncated=afterIndex+1+affected.length<ordered.length;return{root,affected,exact:true,truncated:incoming.truncated||outgoing.truncated||rowLimitTruncated,...rowLimitTruncated?{nextCursor:encodeQueryCursor(cursorFingerprint,affected.at(-1)?.id??root)}:{},cost:{visitedNodes:incoming.cost.visitedNodes+outgoing.cost.visitedNodes,inspectedEdges:incoming.cost.inspectedEdges+outgoing.cost.inspectedEdges}}}function analyzeUnidirectionalGraphImpact(graph,root,options){const direction=options.direction;const maxDepth=options.maxDepth??Number.POSITIVE_INFINITY;const limit=options.limit??Number.POSITIVE_INFINITY;const{fingerprint:cursorFingerprint,after}=resolveImpactCursor(root,options,direction,maxDepth);const{adjacency,inspectedEdges}=buildImpactAdjacency(graph,direction,options.kinds);const state={queue:[{id:root,depth:0}],seen:new Set([root]),parents:new Map,affected:[],cursorFound:after===void 0||after===root};let visitedNodes=0;let truncated=false;let rowLimitTruncated=false;traversal:for(let index=0;index<state.queue.length;index+=1){options.signal?.throwIfAborted();const current=state.queue[index];visitedNodes+=1;const adjacent=[...adjacency.get(current.id)].sort();if(current.depth>=maxDepth){if(adjacent.some(id=>!state.seen.has(id)))truncated=true;continue}for(const id of adjacent){const outcome=visitImpactNeighbor(state,id,current,root,after,limit);if(outcome==="truncate"){truncated=true;rowLimitTruncated=true;break traversal}}}if(!state.cursorFound){throw new TypeError(`Unknown impact cursor item: ${after}`)}return{root,affected:state.affected,exact:true,truncated,...rowLimitTruncated?{nextCursor:encodeQueryCursor(cursorFingerprint,state.affected.at(-1)?.id??root)}:{},cost:{visitedNodes,inspectedEdges}}}function analyzeGraphImpact(graph,root,options={}){const direction=options.direction??"outgoing";if(direction!=="both"){return analyzeUnidirectionalGraphImpact(graph,root,{...options,direction})}const maxDepth=options.maxDepth??Number.POSITIVE_INFINITY;const limit=options.limit??Number.POSITIVE_INFINITY;const{fingerprint,after}=resolveImpactCursor(root,options,direction,maxDepth);return analyzeBidirectionalGraphImpact(graph,root,options,after,limit,fingerprint)}function analyzeKnowledgeGraph(graph){const nodes=[...graph.nodes()];const weak=createAdjacency(nodes);const directed=createAdjacency(nodes);for(const edge of graph.edges()){appendNeighbor(weak,edge.source,edge.target);appendNeighbor(weak,edge.target,edge.source);appendNeighbor(directed,edge.source,edge.target)}const components=[];const visited=new Set;for(const start of nodes){if(visited.has(start))continue;const component=[];const stack=[start];visited.add(start);while(stack.length>0){const current=stack.pop();component.push(current);for(const neighbor of weak.get(current)){if(visited.has(neighbor))continue;visited.add(neighbor);stack.push(neighbor)}}components.push(component)}const degrees=nodes.map(id=>({id,degree:weak.get(id).size}));const maximum=Math.max(0,...degrees.map(({degree})=>degree));return{components:sortComponents(components),stronglyConnected:stronglyConnectedComponents(nodes,directed),orphans:degrees.filter(({degree})=>degree===0).map(({id})=>id),hubs:degrees.filter(({degree})=>degree>0&°ree===maximum),exact:true,provenance:{algorithm:"component-degree",edgeFamily:"all"}}}function compareRelationshipSnapshots(before,after){const earlier=new Map(before.edges.map(edge=>[relationshipEdgeKey(edge),edge]));const later=new Map(after.edges.map(edge=>[relationshipEdgeKey(edge),edge]));return{fromVersion:before.version,toVersion:after.version,added:[...later].filter(([key])=>!earlier.has(key)).map(([,edge])=>edge),removed:[...earlier].filter(([key])=>!later.has(key)).map(([,edge])=>edge),unchangedCount:[...earlier.keys()].filter(key=>later.has(key)).length,exact:true}}export{analyzeGraphImpact,analyzeKnowledgeGraph,analyzeRelationshipExecution,compareRelationshipSnapshots};
|
|
410
2
|
//# sourceMappingURL=relationship-analytics.js.map
|
|
411
|
-
//# debugId=3167c288-0bcc-5a66-8aa0-ca5876ed7d36
|