@weftlet/toolkit 0.1.1 → 0.2.0

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 (52) hide show
  1. package/README.md +39 -3
  2. package/THIRD_PARTY_NOTICES.md +33 -0
  3. package/dist/application/hydrator.js +18 -5
  4. package/dist/application/overlay.js +46 -9
  5. package/dist/application/saved-evidence.d.ts +1 -0
  6. package/dist/configuration/config.d.ts +4 -0
  7. package/dist/configuration/config.js +12 -0
  8. package/dist/configuration/scip-project.d.ts +9 -0
  9. package/dist/configuration/scip-project.js +40 -0
  10. package/dist/extraction/codex-auth.js +9 -2
  11. package/dist/extraction/codex-command.d.ts +8 -0
  12. package/dist/extraction/codex-command.js +81 -0
  13. package/dist/extraction/document-references.d.ts +18 -0
  14. package/dist/extraction/document-references.js +94 -0
  15. package/dist/extraction/document.d.ts +9 -2
  16. package/dist/extraction/document.js +44 -46
  17. package/dist/extraction/module-request.d.ts +3 -0
  18. package/dist/extraction/module-request.js +25 -0
  19. package/dist/extraction/routing.d.ts +14 -0
  20. package/dist/extraction/routing.js +151 -0
  21. package/dist/extraction/scip-project.d.ts +3 -0
  22. package/dist/extraction/scip-project.js +33 -0
  23. package/dist/extraction/semantic-process.js +17 -5
  24. package/dist/extraction/semantic.js +13 -2
  25. package/dist/extraction/static.d.ts +7 -3
  26. package/dist/extraction/static.js +15 -9
  27. package/dist/graph/query.js +21 -34
  28. package/dist/graph/ranking.d.ts +10 -0
  29. package/dist/graph/ranking.js +85 -0
  30. package/dist/interfaces/doctor.js +12 -3
  31. package/docs/ADR-002-saved-evidence.md +7 -1
  32. package/docs/ADR-003-draft-overlays.md +6 -0
  33. package/docs/ADR-004-rdf-query-path.md +6 -0
  34. package/docs/ADR-006-provider-boundaries.md +5 -0
  35. package/docs/ADR-008-weftlet-packages.md +2 -1
  36. package/docs/ADR-009-release-automation.md +39 -0
  37. package/docs/ADR-010-committed-source-indexing.md +77 -0
  38. package/docs/ADR-011-explicit-document-links.md +48 -0
  39. package/docs/ADR-012-impact-ranking.md +50 -0
  40. package/docs/ADR-013-relative-module-requests.md +58 -0
  41. package/docs/ADR-014-routing-declarations.md +108 -0
  42. package/docs/CONSUMER-TRIAL.md +165 -0
  43. package/docs/ENVIRONMENT-VALIDATION.md +9 -0
  44. package/docs/IMPACT-EVALUATION.md +363 -0
  45. package/docs/PROVIDERS.md +30 -2
  46. package/docs/RELEASING.md +128 -116
  47. package/docs/ROADMAP.md +49 -8
  48. package/docs/SOURCE-INVENTORY.md +10 -0
  49. package/docs/VALIDATION.md +394 -0
  50. package/docs/VIEWER.md +5 -0
  51. package/docs/extraction-manifest.json +104 -16
  52. package/package.json +9 -3
@@ -24,7 +24,7 @@
24
24
  "destinationPath": "THIRD_PARTY_NOTICES.md",
25
25
  "sourceSha256": "c98c42f3c3c74f4c4f38f45b785ea15de439ad6471d82040d13100b36616b01e",
26
26
  "modified": true,
27
- "destinationSha256": "1c8bb26c7385fef7d391db9c89797b6f45bf6c5b102d7e832295783eb6c28d1a"
27
+ "destinationSha256": "cd1b40a873371c1fb20599ae8dc5d1131ea4ba650c1f4151415e2cb038339d8d"
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": "acc98f285f29b2b124cd863c391d575b87e8bdd51756223d76765a868e6ee805"
111
+ "destinationSha256": "c7a5cbf191d699a51a22fb961ba84e9f73521c0cc332c697f67a9267812de9ee"
112
112
  },
113
113
  {
114
114
  "sourcePath": "tools/context-graph/packages/core/LICENSE",
@@ -143,14 +143,14 @@
143
143
  "destinationPath": "packages/core/package.json",
144
144
  "sourceSha256": "2a29066eb8452f22fafcb06bb035a84dda93c5705dba32aba600a1b7e5aaf19c",
145
145
  "modified": true,
146
- "destinationSha256": "cfa4fb46c486bf3b06a72bb90adc8521fad1afd20b5cded9c5b0d177ffce0438"
146
+ "destinationSha256": "b7ab260df2ff6005788e6891449205b9b9c9f96aca13b680578a4f776aa21b52"
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": "64a30913c01ff2f3e112a6bcafbc142cb91fc5482f01b2aa90fae9382252dbfa"
153
+ "destinationSha256": "0287d0640f2ff078da19be1439d02fcab22998262562d4af7b5f26ddca0839f4"
154
154
  },
155
155
  {
156
156
  "sourcePath": "tools/context-graph/packages/core/src/index.ts",
@@ -192,21 +192,21 @@
192
192
  "destinationPath": "scripts/check-publication.mjs",
193
193
  "sourceSha256": "88692c21d34cef2d2e5b20c92ab3ec26cbe6336889dbb7b534c681ded7f466b2",
194
194
  "modified": true,
195
- "destinationSha256": "6aa819a74fea8b161396b3a8c52e8e86ea2db856bc10ffbfdebaf22fa0af2cfe"
195
+ "destinationSha256": "546465bb9907051ebbae9f1c421b8b7be23414ce51c44891092d0fb793f67e8b"
196
196
  },
197
197
  {
198
198
  "sourcePath": "tools/context-graph/scripts/generate-third-party-notices.mjs",
199
199
  "destinationPath": "scripts/generate-third-party-notices.mjs",
200
200
  "sourceSha256": "42cd4996ecab49b008634958e47b0a9eadf9ea775678b8daaeeafea59eaabadf",
201
201
  "modified": true,
202
- "destinationSha256": "5caf7a08a42e6c482a5c46d87e71413a6776a5af34685dbe98a16ba7035f5c0c"
202
+ "destinationSha256": "6e9ddb9a0985e2c39d8386168871efeb2589f6bc1bf8c24684cf6c546eced1b2"
203
203
  },
204
204
  {
205
205
  "sourcePath": "tools/context-graph/src/agent-context.test.ts",
206
206
  "destinationPath": "src/application/agent-context.test.ts",
207
207
  "sourceSha256": "cb87b9b7e18ae5d8ba39d4ebf1d45556479d6efb3ffa75276bc6164ee2bf30f1",
208
208
  "modified": true,
209
- "destinationSha256": "f1ed006615ae0d07fb924c60fccad90a3f8cd4e5f12898d4a07db0a5fa65e7d5"
209
+ "destinationSha256": "c72ba1d20d1ad85ee295a7041e85a99cf973b6114eff21524d808997929e3184"
210
210
  },
211
211
  {
212
212
  "sourcePath": "tools/context-graph/src/agent-context.ts",
@@ -248,14 +248,14 @@
248
248
  "destinationPath": "src/configuration/config.test.ts",
249
249
  "sourceSha256": "70bcda6d6b48ff6fa03223c9420fe3e0e3e32c688e0a14f11034515e0707dee4",
250
250
  "modified": true,
251
- "destinationSha256": "ae67cb42f86dbd72d09eac20a0755080bf9394e849dc4fdfdfe0a43b0296c6b2"
251
+ "destinationSha256": "ff4d15018ec35d21a95c589cf2c74bce2e340f9042b2d3ecaabca5889609e3aa"
252
252
  },
253
253
  {
254
254
  "sourcePath": "tools/context-graph/src/config.ts",
255
255
  "destinationPath": "src/configuration/config.ts",
256
256
  "sourceSha256": "e9ee8cf2134d274aa6f6a21545959fbec97e958181d9032c073293f28e04d6ca",
257
257
  "modified": true,
258
- "destinationSha256": "ce6550967829b74147909121735c4dccf70982c3f9ee9ddc860b4f63535d5de0"
258
+ "destinationSha256": "5e34e4dfa38219570bd6f13239609b432830e76162f44a768a929895f66dc02a"
259
259
  },
260
260
  {
261
261
  "sourcePath": "tools/context-graph/src/core.ts",
@@ -283,7 +283,7 @@
283
283
  "destinationPath": "src/extraction/document.ts",
284
284
  "sourceSha256": "62a2da37d8cc0637b192b7e70ae7a0dce72244d335da9df0e0ad9b0eb7c4e1f1",
285
285
  "modified": true,
286
- "destinationSha256": "819372a1ba01ed2204e2ed620d4afefb03ab8b7431e77e02f2b61bc605807124"
286
+ "destinationSha256": "de198e73b3b2c828c99bb35c806461dba06526df9ae94592926d26346fbefe79"
287
287
  },
288
288
  {
289
289
  "sourcePath": "tools/context-graph/src/git.test.ts",
@@ -311,14 +311,14 @@
311
311
  "destinationPath": "src/application/hydrator.test.ts",
312
312
  "sourceSha256": "95f20a526fe69ce3a506ef01da1c20827e09d631a34126e781a07979cc43de07",
313
313
  "modified": true,
314
- "destinationSha256": "83ca72d394d9eac8eef5dbc9438c7914442dbad3bbaa07c33f1e756e6d11fd39"
314
+ "destinationSha256": "bbd264bf4224632f3e0fea81718910fab4dd5f8e79680faccf61059219bf9dde"
315
315
  },
316
316
  {
317
317
  "sourcePath": "tools/context-graph/src/hydrator.ts",
318
318
  "destinationPath": "src/application/hydrator.ts",
319
319
  "sourceSha256": "bb41c5b53b26da10274d8b967b99c78ff12b485df16bfc66445252e35c94fb9d",
320
320
  "modified": true,
321
- "destinationSha256": "c95592ccb8626e8d3629f35d24e51d9d99be698c8ae270c794df47e4b3a46d14"
321
+ "destinationSha256": "8c751fe04922d1117728672b78a1de2d6f42f403e9d506f387c95661e641a5c0"
322
322
  },
323
323
  {
324
324
  "sourcePath": "tools/context-graph/src/index.ts",
@@ -388,14 +388,14 @@
388
388
  "destinationPath": "src/graph/query.test.ts",
389
389
  "sourceSha256": "ba07c52566da979fcbb451b0c0c99b466521993cb49415ff8b35df2b01d4ecaf",
390
390
  "modified": true,
391
- "destinationSha256": "e0030981026a6643d8032174f37a0a41b17724ee6a86dae55e6b12c51f5de77f"
391
+ "destinationSha256": "68d7405765dec5975370f79caaf8708db42dd3dd464a7ec9c3919c796ee81b79"
392
392
  },
393
393
  {
394
394
  "sourcePath": "tools/context-graph/src/query.ts",
395
395
  "destinationPath": "src/graph/query.ts",
396
396
  "sourceSha256": "4d67f87ca660cefe9686fb5b775f86a997a25d539819ea81d321c8bd1e0aaa39",
397
397
  "modified": true,
398
- "destinationSha256": "93e813d2e70d09522418e07f9ffeb36d71795c026099a8b57559b0c10b150a76"
398
+ "destinationSha256": "ead61dfde748cd1a02c8b1a14dc729173a6b85ec3b8213af2bd5169c60b70253"
399
399
  },
400
400
  {
401
401
  "sourcePath": "tools/context-graph/src/request.test.ts",
@@ -451,7 +451,7 @@
451
451
  "destinationPath": "src/extraction/semantic.ts",
452
452
  "sourceSha256": "1a41fb3fc5a9508c76be59d1c50b74d70ec96411fcbb7f63b0e098c1813d8473",
453
453
  "modified": true,
454
- "destinationSha256": "64b4e55294ab37bc84a1c2ad0a8a563003d8ad2329e224ef0c6822965b14d257"
454
+ "destinationSha256": "9872f2b8ac3bd14f33194d76082fecf0fd34325a6e74b2397f538898aa8fe21e"
455
455
  },
456
456
  {
457
457
  "sourcePath": "tools/context-graph/src/snapshot-checks.test.ts",
@@ -479,7 +479,7 @@
479
479
  "destinationPath": "src/extraction/static.ts",
480
480
  "sourceSha256": "f8dcff3e10361314c06911dc7cec1e2cb0f8d9af68a6c61a30b2a741c5c3a385",
481
481
  "modified": true,
482
- "destinationSha256": "39ada50a57e2130d27c22eb18531c3feb7160004b198eb5904950227e57012df"
482
+ "destinationSha256": "94190f11651b21372b2c3a834e30cde5d333893bfad0b66755e5f698608d2fdb"
483
483
  },
484
484
  {
485
485
  "sourcePath": "tools/context-graph/src/storage.ts",
@@ -577,11 +577,16 @@
577
577
  ".github/workflows/context-graph.yml"
578
578
  ],
579
579
  "authoredPaths": [
580
+ ".changeset/README.md",
581
+ ".changeset/config.json",
582
+ ".changeset/release-plan.json",
580
583
  ".github/workflows/check.yml",
581
584
  ".github/workflows/publish.yml",
585
+ ".github/workflows/version.yml",
582
586
  ".gitignore",
583
587
  ".npmrc",
584
588
  ".nvmrc",
589
+ "CHANGELOG.md",
585
590
  "CONTRIBUTING.md",
586
591
  "README.md",
587
592
  "SECURITY.md",
@@ -596,8 +601,16 @@
596
601
  "docs/ADR-006-provider-boundaries.md",
597
602
  "docs/ADR-007-toolkit-modules.md",
598
603
  "docs/ADR-008-weftlet-packages.md",
604
+ "docs/ADR-009-release-automation.md",
605
+ "docs/ADR-010-committed-source-indexing.md",
606
+ "docs/ADR-011-explicit-document-links.md",
607
+ "docs/ADR-012-impact-ranking.md",
608
+ "docs/ADR-013-relative-module-requests.md",
609
+ "docs/ADR-014-routing-declarations.md",
599
610
  "docs/CLOUD-ENVIRONMENT.md",
611
+ "docs/CONSUMER-TRIAL.md",
600
612
  "docs/ENVIRONMENT-VALIDATION.md",
613
+ "docs/IMPACT-EVALUATION.md",
601
614
  "docs/MIGRATING-TO-WEFTLET.md",
602
615
  "docs/PROVIDERS.md",
603
616
  "docs/RELEASING.md",
@@ -612,6 +625,47 @@
612
625
  "docs/licenses/lru-cache-11.5.3-BlueOak.md",
613
626
  "docs/licenses/negotiate-1.0.1-BSD.txt",
614
627
  "docs/licenses/spark-md5-3.0.2-MIT.txt",
628
+ "evaluations/dispatch/README.md",
629
+ "evaluations/dispatch/baseline.json",
630
+ "evaluations/dispatch/cases.json",
631
+ "evaluations/dispatch/context-graph.config.json",
632
+ "evaluations/dispatch/project/README.md",
633
+ "evaluations/dispatch/project/docs/delivery-flow.md",
634
+ "evaluations/dispatch/project/docs/dispatch-contract.md",
635
+ "evaluations/dispatch/project/docs/dispatch-policy.md",
636
+ "evaluations/dispatch/project/package.json",
637
+ "evaluations/dispatch/project/routing/dispatch.json",
638
+ "evaluations/dispatch/project/src/api/dispatch.ts",
639
+ "evaluations/dispatch/project/src/archive/consumer.ts",
640
+ "evaluations/dispatch/project/src/audit/consumer.ts",
641
+ "evaluations/dispatch/project/src/contracts/dispatch-plan.ts",
642
+ "evaluations/dispatch/project/src/contracts/dispatch-receipt.ts",
643
+ "evaluations/dispatch/project/src/contracts/dispatch-request.ts",
644
+ "evaluations/dispatch/project/src/dispatch/executor.ts",
645
+ "evaluations/dispatch/project/src/dispatch/outcomes.ts",
646
+ "evaluations/dispatch/project/src/dispatch/planner.ts",
647
+ "evaluations/dispatch/project/src/dispatch/policy.ts",
648
+ "evaluations/dispatch/project/src/dispatch/retry.ts",
649
+ "evaluations/dispatch/project/src/refund/planner.ts",
650
+ "evaluations/dispatch/project/src/refund/policy.ts",
651
+ "evaluations/dispatch/project/src/transport/queue.ts",
652
+ "evaluations/dispatch/project/test/archive.test.ts",
653
+ "evaluations/dispatch/project/test/dispatch.test.ts",
654
+ "evaluations/dispatch/project/test/policy.test.ts",
655
+ "evaluations/dispatch/project/test/refund.test.ts",
656
+ "evaluations/dispatch/project/tsconfig.json",
657
+ "evaluations/dispatch/relative-imports-baseline.json",
658
+ "evaluations/dispatch/routing-baseline.json",
659
+ "evaluations/dispatch/routing-protocol.md",
660
+ "evaluations/dispatch/routing.config.json",
661
+ "evaluations/weftlet/baseline.json",
662
+ "evaluations/weftlet/cases.json",
663
+ "evaluations/weftlet/context-graph.config.json",
664
+ "evaluations/weftlet/document-links-baseline.json",
665
+ "evaluations/weftlet/document-only.mjs",
666
+ "evaluations/weftlet/ranking-baseline.json",
667
+ "evaluations/weftlet/source-project-baseline.json",
668
+ "evaluations/weftlet/source-project.config.json",
615
669
  "examples/generic-typescript/context-graph.oml.config.json",
616
670
  "examples/pipeline/context-graph.config.json",
617
671
  "examples/pipeline/docs/admission.md",
@@ -637,36 +691,69 @@
637
691
  "examples/pipeline/test/pipeline.test.ts",
638
692
  "examples/pipeline/tsconfig.json",
639
693
  "mcp-launcher.mjs",
694
+ "packages/core/CHANGELOG.md",
640
695
  "pnpm-lock.yaml",
641
696
  "pnpm-workspace.yaml",
642
697
  "reviewed-licenses.json",
643
698
  "runtime-check.d.mts",
644
699
  "runtime-check.mjs",
700
+ "scripts/check-release-plan.mjs",
645
701
  "scripts/check-restoration.mjs",
646
702
  "scripts/clean-build.mjs",
647
703
  "scripts/cloud-install.sh",
704
+ "scripts/evaluation/protocol.test.ts",
705
+ "scripts/evaluation/protocol.ts",
706
+ "scripts/evaluation/run.test.ts",
707
+ "scripts/evaluation/run.ts",
708
+ "scripts/evaluation/score.test.ts",
709
+ "scripts/evaluation/score.ts",
710
+ "scripts/git-content.mjs",
711
+ "scripts/inventory.test.ts",
648
712
  "scripts/npm-auth.mjs",
649
713
  "scripts/npm-auth.test.ts",
650
714
  "scripts/npm-command.mjs",
651
715
  "scripts/npm-command.test.ts",
652
716
  "scripts/package-manager.mjs",
653
717
  "scripts/package-manager.test.ts",
718
+ "scripts/publication-state.mjs",
719
+ "scripts/publication-state.test.ts",
720
+ "scripts/record-release.mjs",
654
721
  "scripts/registry-publication.mjs",
655
722
  "scripts/registry-publication.test.ts",
723
+ "scripts/release-plan.mjs",
724
+ "scripts/release-records.mjs",
725
+ "scripts/release-records.test.ts",
656
726
  "scripts/release.mjs",
727
+ "scripts/restore-publication-state.mjs",
657
728
  "scripts/update-inventory.mjs",
729
+ "scripts/version-packages.mjs",
730
+ "scripts/version-packages.test.ts",
658
731
  "src/application/overlay.test.ts",
659
732
  "src/application/overlay.ts",
660
733
  "src/application/saved-evidence.ts",
661
734
  "src/cli.ts",
735
+ "src/configuration/scip-project.ts",
662
736
  "src/extraction/codex-auth.test.ts",
663
737
  "src/extraction/codex-auth.ts",
738
+ "src/extraction/codex-command.test.ts",
739
+ "src/extraction/codex-command.ts",
740
+ "src/extraction/document-references.ts",
741
+ "src/extraction/document.test.ts",
742
+ "src/extraction/module-request.test.ts",
743
+ "src/extraction/module-request.ts",
664
744
  "src/extraction/providers.test.ts",
665
745
  "src/extraction/providers.ts",
746
+ "src/extraction/routing.test.ts",
747
+ "src/extraction/routing.ts",
748
+ "src/extraction/scip-project.test.ts",
749
+ "src/extraction/scip-project.ts",
750
+ "src/extraction/semantic-process.test.ts",
666
751
  "src/extraction/semantic-process.ts",
667
752
  "src/governance/governance.test.ts",
668
753
  "src/governance/governance.ts",
669
754
  "src/graph/authority.ts",
755
+ "src/graph/ranking.test.ts",
756
+ "src/graph/ranking.ts",
670
757
  "src/graph/rdf.ts",
671
758
  "src/infrastructure/module-resolution.ts",
672
759
  "src/interfaces/doctor.ts",
@@ -684,6 +771,7 @@
684
771
  "tests/module-boundaries.test.ts",
685
772
  "tests/rdf-ontology.test.ts",
686
773
  "tests/rdf.test.ts",
774
+ "tests/routing.test.ts",
687
775
  "tests/runtime.test.ts",
688
776
  "tests/snapshot-lifecycle.test.ts"
689
777
  ],
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@weftlet/toolkit",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
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",
@@ -59,12 +59,15 @@
59
59
  "@opentelemetry/sdk-trace-base": "2.2.0",
60
60
  "@sourcegraph/scip-typescript": "0.4.0",
61
61
  "import-meta-resolve": "4.2.0",
62
+ "mdast-util-from-markdown": "2.1.0",
62
63
  "n3": "2.7.2",
63
64
  "rdf-validate-shacl": "0.6.5",
64
65
  "sparqljs": "3.7.4",
65
- "@weftlet/core": "^0.1.1"
66
+ "@weftlet/core": "^0.2.0"
66
67
  },
67
68
  "devDependencies": {
69
+ "@changesets/cli": "3.0.3",
70
+ "@types/mdast": "4.0.4",
68
71
  "@types/n3": "1.26.1",
69
72
  "@types/node": "20.19.11",
70
73
  "@typescript-eslint/parser": "8.72.0",
@@ -114,6 +117,9 @@
114
117
  "release:prepare": "pnpm context-graph:publication-check && node scripts/release.mjs --prepare",
115
118
  "release:publish": "node scripts/release.mjs --publish",
116
119
  "govern": "tsx src/cli.ts govern --policy architecture.policy.json --output .context-graph/architecture-report.json",
117
- "weftlet": "tsx src/cli.ts"
120
+ "evaluate:impact": "tsx scripts/evaluation/run.ts",
121
+ "weftlet": "tsx src/cli.ts",
122
+ "changeset": "changeset",
123
+ "release:version": "node scripts/version-packages.mjs"
118
124
  }
119
125
  }