@weftlet/toolkit 0.7.0 → 0.7.2

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.
Files changed (50) hide show
  1. package/README.md +40 -29
  2. package/THIRD_PARTY_NOTICES.md +2 -0
  3. package/dist/application/hydrator.js +18 -15
  4. package/dist/application/overlay.js +9 -9
  5. package/dist/application/saved-paths.d.ts +1 -1
  6. package/dist/application/semantic-run.d.ts +1 -1
  7. package/dist/extraction/ontology.d.ts +2 -0
  8. package/dist/extraction/ontology.js +28 -13
  9. package/dist/graph/code-coverage.js +2 -2
  10. package/dist/graph/code-rdf.d.ts +3 -2
  11. package/dist/graph/code-rdf.js +21 -14
  12. package/dist/graph/impact-signals.d.ts +7 -0
  13. package/dist/graph/impact-signals.js +54 -0
  14. package/dist/graph/neighborhood.js +3 -3
  15. package/dist/graph/partitioned-shacl.d.ts +14 -0
  16. package/dist/graph/partitioned-shacl.js +66 -0
  17. package/dist/graph/path-search.d.ts +6 -4
  18. package/dist/graph/path-search.js +50 -24
  19. package/dist/graph/paths-renderer.js +1 -1
  20. package/dist/graph/paths.d.ts +1 -1
  21. package/dist/graph/paths.js +5 -5
  22. package/dist/graph/ranking.d.ts +1 -1
  23. package/dist/graph/ranking.js +17 -9
  24. package/dist/graph/rdf-partitions.d.ts +24 -0
  25. package/dist/graph/rdf-partitions.js +170 -0
  26. package/dist/graph/rdf-projection.d.ts +7 -0
  27. package/dist/graph/rdf-projection.js +27 -0
  28. package/dist/graph/rdf-records.d.ts +12 -0
  29. package/dist/graph/rdf-records.js +90 -0
  30. package/dist/graph/rdf.d.ts +10 -10
  31. package/dist/graph/rdf.js +66 -97
  32. package/dist/graph/validation-progress.d.ts +4 -1
  33. package/dist/infrastructure/json-digest.d.ts +2 -1
  34. package/dist/infrastructure/json-digest.js +2 -2
  35. package/dist/interfaces/cli.js +1 -1
  36. package/dist/storage/storage.d.ts +3 -0
  37. package/dist/storage/storage.js +37 -13
  38. package/dist/storage/streaming-json.d.ts +5 -0
  39. package/dist/storage/streaming-json.js +45 -0
  40. package/dist/visualization/viewer-interaction.js +1 -1
  41. package/docs/1.0-WORK-QUEUE.md +25 -8
  42. package/docs/ADR-012-impact-ranking.md +2 -1
  43. package/docs/ADR-030-bounded-evidence-paths.md +21 -18
  44. package/docs/ADR-040-bounded-graph-io.md +90 -0
  45. package/docs/ADR-041-bounded-relationship-retrieval.md +77 -0
  46. package/docs/RELEASING.md +3 -3
  47. package/docs/VALIDATION.md +121 -0
  48. package/docs/benchmarks/large-graph-2026-11-02/result.json +156 -0
  49. package/docs/extraction-manifest.json +37 -11
  50. package/package.json +5 -2
@@ -24,7 +24,7 @@
24
24
  "destinationPath": "THIRD_PARTY_NOTICES.md",
25
25
  "sourceSha256": "c98c42f3c3c74f4c4f38f45b785ea15de439ad6471d82040d13100b36616b01e",
26
26
  "modified": true,
27
- "destinationSha256": "eab5289d1e846769186cedba88bfde7c8a00a88d2c0550d1b37f41a336b37a7f"
27
+ "destinationSha256": "3a3149ef683ffbbf3925ecd7975a7c0a5c24db66b4303f6044ba0fe94c9a1310"
28
28
  },
29
29
  {
30
30
  "sourcePath": "tools/context-graph/action/action.yml",
@@ -108,7 +108,7 @@
108
108
  "destinationPath": "package.json",
109
109
  "sourceSha256": "a575dbb2fed8c554b95e8e9b3e03a0c21cab1be7249860bbebc18e046b2ff78d",
110
110
  "modified": true,
111
- "destinationSha256": "a655f7c89368fe1709208f56cd373b6371cb83fb6323002902311f16639df972"
111
+ "destinationSha256": "5ca2ea1f62e6b8393e731f761a1732a8ccf464948a905ab9fe246ae5d941dda8"
112
112
  },
113
113
  {
114
114
  "sourcePath": "tools/context-graph/packages/core/LICENSE",
@@ -129,7 +129,7 @@
129
129
  "destinationPath": "packages/core/README.md",
130
130
  "sourceSha256": "6044bf7b9a3dc793f41e2ff048546ed11938957d10a5b143eb1739ac4cd7477c",
131
131
  "modified": true,
132
- "destinationSha256": "7c885a42a37dd41d6ecb4a88e0f248331e37063eeb79eeeb3dff6a0e0bb42153"
132
+ "destinationSha256": "1c0c80c8a85f9240ace5a2f01d102646fa293ef246a5f056eb94c7efa0f6e401"
133
133
  },
134
134
  {
135
135
  "sourcePath": "tools/context-graph/packages/core/THIRD_PARTY_NOTICES.md",
@@ -143,21 +143,21 @@
143
143
  "destinationPath": "packages/core/package.json",
144
144
  "sourceSha256": "2a29066eb8452f22fafcb06bb035a84dda93c5705dba32aba600a1b7e5aaf19c",
145
145
  "modified": true,
146
- "destinationSha256": "f427d23515b4ca14281731996073f0f51714a139369e1663679d61564a8c143b"
146
+ "destinationSha256": "4a17cd04c7ec5a3a96ec0767d3883d588dfe6724822f254ed91f452b30b939bc"
147
147
  },
148
148
  {
149
149
  "sourcePath": "tools/context-graph/packages/core/src/core.ts",
150
150
  "destinationPath": "packages/core/src/core.ts",
151
151
  "sourceSha256": "cb3f4eb7bfe9f458494607406664445a276aad37235930a043d400ea9211ed16",
152
152
  "modified": true,
153
- "destinationSha256": "bd0da7ce094987c3d847403105998b9a01f2d2fcc308bf1d1ec16feb8409b769"
153
+ "destinationSha256": "b273b08720993c8195031f8b45af2e304705d9fe605aaeccd8546276bbf81789"
154
154
  },
155
155
  {
156
156
  "sourcePath": "tools/context-graph/packages/core/src/index.ts",
157
157
  "destinationPath": "packages/core/src/index.ts",
158
158
  "sourceSha256": "6cbf51e60ac8c7b21b04870b50b92f6da0a1a3b2fa9dd21331e7e83e7beced05",
159
159
  "modified": true,
160
- "destinationSha256": "d8eb8a4d25d18afa53ed5b4001cbb9af3e91e714def4b95d4b260bcdf974d821"
160
+ "destinationSha256": "506c545aad75289bb4bcc6cb24423e39ad58b5611f20cdae624904d1dc8fa034"
161
161
  },
162
162
  {
163
163
  "sourcePath": "tools/context-graph/packages/core/src/util.test.ts",
@@ -241,7 +241,7 @@
241
241
  "destinationPath": "src/interfaces/cli.ts",
242
242
  "sourceSha256": "c68f5f35a5325cc03811b0d4ffb6d58c31a9b4e6115fcb2c5e4fda9560a34714",
243
243
  "modified": true,
244
- "destinationSha256": "f711ffb1daa45f3d6f8186dd6505143f938a80661f041f4e288c681d11be832b"
244
+ "destinationSha256": "76f40973bed8395d98f8bea5ec9ba95f593899502e05d08aea2f8cb137ac4a51"
245
245
  },
246
246
  {
247
247
  "sourcePath": "tools/context-graph/src/config.test.ts",
@@ -318,7 +318,7 @@
318
318
  "destinationPath": "src/application/hydrator.ts",
319
319
  "sourceSha256": "bb41c5b53b26da10274d8b967b99c78ff12b485df16bfc66445252e35c94fb9d",
320
320
  "modified": true,
321
- "destinationSha256": "394bed3f59049a650ebb94a8ade4f1637b9540633e2f49d3a16ac336fb9c9d7b"
321
+ "destinationSha256": "95b02709378ae5b37e2d3e3ae0ce80801fdb3385b0ec96f1e999ad5c59e5e9ae"
322
322
  },
323
323
  {
324
324
  "sourcePath": "tools/context-graph/src/index.ts",
@@ -367,7 +367,7 @@
367
367
  "destinationPath": "src/extraction/ontology.ts",
368
368
  "sourceSha256": "800fd0a0f8d7e43dcc598a168640563e26919fa2f1fcc871f0a842510b78f319",
369
369
  "modified": true,
370
- "destinationSha256": "4e52ee6a41192ae60f98ada522f27668115e145525c7afb6ec373b034c902f24"
370
+ "destinationSha256": "621f8e278fe52656c1621469afd50e6df79a23c98a4fae54776840541c308ab6"
371
371
  },
372
372
  {
373
373
  "sourcePath": "tools/context-graph/src/portable-fixture.test.ts",
@@ -388,7 +388,7 @@
388
388
  "destinationPath": "src/graph/query.test.ts",
389
389
  "sourceSha256": "ba07c52566da979fcbb451b0c0c99b466521993cb49415ff8b35df2b01d4ecaf",
390
390
  "modified": true,
391
- "destinationSha256": "7b6653f767c2e7445ec19f0cafc9d3fe97494ae139835ec63d335a7210e62c6c"
391
+ "destinationSha256": "20f0766299e66d4b5e7bc4577b6b0937c5bf87f2f1858f7b0205172231f0bb4c"
392
392
  },
393
393
  {
394
394
  "sourcePath": "tools/context-graph/src/query.ts",
@@ -486,7 +486,7 @@
486
486
  "destinationPath": "src/storage/storage.ts",
487
487
  "sourceSha256": "9e38af8e34dc84ccaed5322b37b485e60706c68542271926228fb6d4af3d1f71",
488
488
  "modified": true,
489
- "destinationSha256": "82945a91cc1e02970225e7f9247ee1e3526754462d0f29607a6543c9f07f1619"
489
+ "destinationSha256": "cb0d8647145961e57d0de7a52de58a1e5f29e813fabb4d7a07e2dae8f54ea63a"
490
490
  },
491
491
  {
492
492
  "sourcePath": "tools/context-graph/src/telemetry.test.ts",
@@ -633,6 +633,8 @@
633
633
  "docs/ADR-037-selected-contract-compatibility.md",
634
634
  "docs/ADR-038-monorepo-code-coverage.md",
635
635
  "docs/ADR-039-mapping-proposals.md",
636
+ "docs/ADR-040-bounded-graph-io.md",
637
+ "docs/ADR-041-bounded-relationship-retrieval.md",
636
638
  "docs/CLOUD-ENVIRONMENT.md",
637
639
  "docs/CONSUMER-TRIAL.md",
638
640
  "docs/ENVIRONMENT-VALIDATION.md",
@@ -651,6 +653,7 @@
651
653
  "docs/architecture-baseline.json",
652
654
  "docs/architecture-policy.md",
653
655
  "docs/assessments/pre-1.0-2026-10-28.json",
656
+ "docs/benchmarks/large-graph-2026-11-02/result.json",
654
657
  "docs/benchmarks/validation-2026-10-28/README.md",
655
658
  "docs/benchmarks/validation-2026-10-28/large.json",
656
659
  "docs/benchmarks/validation-2026-10-28/lifecycle.json",
@@ -777,6 +780,10 @@
777
780
  "evaluations/mapping-proposals/inputs.lock.json",
778
781
  "evaluations/mapping-proposals/protocol.json",
779
782
  "evaluations/monorepo-coverage/README.md",
783
+ "evaluations/relationship-retrieval/README.md",
784
+ "evaluations/relationship-retrieval/baseline.json",
785
+ "evaluations/relationship-retrieval/candidate.json",
786
+ "evaluations/relationship-retrieval/protocol.md",
780
787
  "evaluations/static-calls/README.md",
781
788
  "evaluations/static-calls/results/2026-10-29.json",
782
789
  "evaluations/weftlet/baseline.json",
@@ -816,6 +823,8 @@
816
823
  "packages/core/CHANGELOG.md",
817
824
  "packages/core/src/bindings.ts",
818
825
  "packages/core/src/calls.ts",
826
+ "packages/core/src/canonical-digest.test.ts",
827
+ "packages/core/src/canonical-digest.ts",
819
828
  "packages/core/src/code-coverage.ts",
820
829
  "packages/core/src/code-types.ts",
821
830
  "packages/core/src/code.test.ts",
@@ -864,6 +873,8 @@
864
873
  "scripts/git-content.d.mts",
865
874
  "scripts/git-content.mjs",
866
875
  "scripts/inventory.test.ts",
876
+ "scripts/large-graph/lifecycle.ts",
877
+ "scripts/large-graph/run.ts",
867
878
  "scripts/mapping-proposal-study/run.ts",
868
879
  "scripts/mapping-study/assessment.test.ts",
869
880
  "scripts/mapping-study/assessment.ts",
@@ -888,6 +899,8 @@
888
899
  "scripts/release-records.test.ts",
889
900
  "scripts/release.mjs",
890
901
  "scripts/restore-publication-state.mjs",
902
+ "scripts/retrieval-study/preservation.ts",
903
+ "scripts/retrieval-study/run.ts",
891
904
  "scripts/smoke-mapping-proposals.mjs",
892
905
  "scripts/smoke-traversal.mjs",
893
906
  "scripts/update-inventory.mjs",
@@ -1006,12 +1019,14 @@
1006
1019
  "src/graph/evidence-description.ts",
1007
1020
  "src/graph/identity-preflight.test.ts",
1008
1021
  "src/graph/identity-preflight.ts",
1022
+ "src/graph/impact-signals.ts",
1009
1023
  "src/graph/neighborhood-renderer.ts",
1010
1024
  "src/graph/neighborhood-request.ts",
1011
1025
  "src/graph/neighborhood.test.ts",
1012
1026
  "src/graph/neighborhood.ts",
1013
1027
  "src/graph/obligation-rdf.ts",
1014
1028
  "src/graph/obligation-shapes.ts",
1029
+ "src/graph/partitioned-shacl.ts",
1015
1030
  "src/graph/path-request.ts",
1016
1031
  "src/graph/path-search.test.ts",
1017
1032
  "src/graph/path-search.ts",
@@ -1020,6 +1035,9 @@
1020
1035
  "src/graph/paths.ts",
1021
1036
  "src/graph/ranking.test.ts",
1022
1037
  "src/graph/ranking.ts",
1038
+ "src/graph/rdf-partitions.ts",
1039
+ "src/graph/rdf-projection.ts",
1040
+ "src/graph/rdf-records.ts",
1023
1041
  "src/graph/rdf.ts",
1024
1042
  "src/graph/shacl-shapes.ts",
1025
1043
  "src/graph/snapshot-context.ts",
@@ -1058,6 +1076,8 @@
1058
1076
  "src/storage/atomic-rename.ts",
1059
1077
  "src/storage/mapping-proposals.test.ts",
1060
1078
  "src/storage/mapping-proposals.ts",
1079
+ "src/storage/streaming-json.test.ts",
1080
+ "src/storage/streaming-json.ts",
1061
1081
  "src/telemetry.ts",
1062
1082
  "src/visualization/evidence-sources.ts",
1063
1083
  "src/visualization/path-parity.test.ts",
@@ -1078,9 +1098,12 @@
1078
1098
  "tests/fixtures/code-evidence-project.ts",
1079
1099
  "tests/fixtures/compatibility-cases.ts",
1080
1100
  "tests/fixtures/compatibility-project.ts",
1101
+ "tests/fixtures/large-typescript-project.ts",
1081
1102
  "tests/fixtures/mapping-project.ts",
1082
1103
  "tests/fixtures/monorepo-project.ts",
1083
1104
  "tests/fixtures/obligation-project.ts",
1105
+ "tests/fixtures/rdf-070-reference.ts",
1106
+ "tests/fixtures/relationship-retrieval-project.ts",
1084
1107
  "tests/fixtures/shacl.ts",
1085
1108
  "tests/fixtures/static-call-project.ts",
1086
1109
  "tests/fixtures/symbol-bindings.ts",
@@ -1089,12 +1112,15 @@
1089
1112
  "tests/hydration-plan.test.ts",
1090
1113
  "tests/identity-preflight.test.ts",
1091
1114
  "tests/implementation-coverage.test.ts",
1115
+ "tests/large-graph-lifecycle.test.ts",
1092
1116
  "tests/mapping-proposals.test.ts",
1093
1117
  "tests/module-boundaries.test.ts",
1094
1118
  "tests/monorepo-coverage.test.ts",
1095
1119
  "tests/physical-file-kinds.test.ts",
1096
1120
  "tests/rdf-ontology.test.ts",
1121
+ "tests/rdf-scaling-parity.test.ts",
1097
1122
  "tests/rdf.test.ts",
1123
+ "tests/relationship-retrieval.test.ts",
1098
1124
  "tests/routing.test.ts",
1099
1125
  "tests/runtime.test.ts",
1100
1126
  "tests/semantic-cache-reuse.test.ts",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@weftlet/toolkit",
3
- "version": "0.7.0",
3
+ "version": "0.7.2",
4
4
  "description": "Evidence-backed context graphs for AI development agents: product intent, contracts, code, tests and runtime behavior",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -53,18 +53,20 @@
53
53
  },
54
54
  "dependencies": {
55
55
  "@comunica/query-sparql": "5.4.1",
56
+ "@discoveryjs/json-ext": "1.1.0",
56
57
  "@modelcontextprotocol/sdk": "1.30.0",
57
58
  "@opentelemetry/api": "1.9.0",
58
59
  "@opentelemetry/resources": "2.2.0",
59
60
  "@opentelemetry/sdk-trace-base": "2.2.0",
60
61
  "@sourcegraph/scip-typescript": "0.4.0",
62
+ "@streamparser/json": "0.0.26",
61
63
  "import-meta-resolve": "4.2.0",
62
64
  "mdast-util-from-markdown": "2.1.0",
63
65
  "n3": "2.7.2",
64
66
  "rdf-validate-shacl": "0.6.5",
65
67
  "sparqljs": "3.7.4",
66
68
  "typescript": "5.5.4",
67
- "@weftlet/core": "^0.7.0"
69
+ "@weftlet/core": "^0.7.2"
68
70
  },
69
71
  "devDependencies": {
70
72
  "@changesets/cli": "3.0.3",
@@ -119,6 +121,7 @@
119
121
  "release:prepare": "pnpm context-graph:publication-check && node scripts/release.mjs --prepare",
120
122
  "release:publish": "node scripts/release.mjs --publish",
121
123
  "govern": "tsx src/cli.ts govern --policy architecture.policy.json --output .context-graph/architecture-report.json",
124
+ "evaluate:retrieval": "tsx scripts/retrieval-study/run.ts",
122
125
  "evaluate:impact": "tsx scripts/evaluation/run.ts",
123
126
  "evaluate:code:check": "node scripts/code-graph-study/check.mjs",
124
127
  "benchmark:shacl": "node scripts/benchmark-shacl.mjs",