@weftlet/toolkit 0.5.0 → 0.6.0

package/docs/extraction-manifest.json

@@ -108,7 +108,7 @@
       "destinationPath": "package.json",
       "sourceSha256": "a575dbb2fed8c554b95e8e9b3e03a0c21cab1be7249860bbebc18e046b2ff78d",
       "modified": true,
-      "destinationSha256": "3e56a3b6a6200e15f684bb490360f2aec0d305dc6c475a176971b188ac5b725d"
+      "destinationSha256": "f7da7073324381a463ddef7bbe1bbffa7f8ff3426b8738420cd41596d0f48332"
     },
     {
       "sourcePath": "tools/context-graph/packages/core/LICENSE",
@@ -129,7 +129,7 @@
       "destinationPath": "packages/core/README.md",
       "sourceSha256": "6044bf7b9a3dc793f41e2ff048546ed11938957d10a5b143eb1739ac4cd7477c",
       "modified": true,
-      "destinationSha256": "c929bd90f5d2bae73554df2dcd0af0ad1bfd45d0843cd7940bde90c42b1266b9"
+      "destinationSha256": "93afe33e737bc8f1d01d53361f6f4ef4b2856be6c2e977f3c3a494bedd2229bf"
     },
     {
       "sourcePath": "tools/context-graph/packages/core/THIRD_PARTY_NOTICES.md",
@@ -143,14 +143,14 @@
       "destinationPath": "packages/core/package.json",
       "sourceSha256": "2a29066eb8452f22fafcb06bb035a84dda93c5705dba32aba600a1b7e5aaf19c",
       "modified": true,
-      "destinationSha256": "cde075a193be99f3d50895d9f764e8fd5848f54a2e5acb0155ce69f454bf8623"
+      "destinationSha256": "b8fe4bb56bdce5da3c5b09c281c185c836a17be941fa406482b2835d83c77467"
     },
     {
       "sourcePath": "tools/context-graph/packages/core/src/core.ts",
       "destinationPath": "packages/core/src/core.ts",
       "sourceSha256": "cb3f4eb7bfe9f458494607406664445a276aad37235930a043d400ea9211ed16",
       "modified": true,
-      "destinationSha256": "00550f6cc7a8caa4120337ebc73e443b988bfdb72d05a2f828c88db502606fe3"
+      "destinationSha256": "2101bb6877714ac9da05d7f9e015a673fe78010f7d5dbbe620e8a3958ff404c9"
     },
     {
       "sourcePath": "tools/context-graph/packages/core/src/index.ts",
@@ -192,7 +192,7 @@
       "destinationPath": "scripts/check-publication.mjs",
       "sourceSha256": "88692c21d34cef2d2e5b20c92ab3ec26cbe6336889dbb7b534c681ded7f466b2",
       "modified": true,
-      "destinationSha256": "6cc62cdbd4bed65d8eff4749fba7003b3fa59c2e5ddcf8e333950468c40986bf"
+      "destinationSha256": "66e66169034b0c04a6d0a5ad21d05fef91a35da18816b40a4441c54cc85258df"
     },
     {
       "sourcePath": "tools/context-graph/scripts/generate-third-party-notices.mjs",
@@ -234,28 +234,28 @@
       "destinationPath": "src/configuration/cache.ts",
       "sourceSha256": "c65c9803657762dbcfd482c58820950d938694a8432f38d65cc35a86eeca216d",
       "modified": true,
-      "destinationSha256": "676467260f107d5120c19c11a6a32d785acbf6a0f69c03f96074ccd2c5e05b32"
+      "destinationSha256": "aefa63517c2a92f426d45d78619af7e5fe0e3d41c1dc50a1c14db824b75b9879"
     },
     {
       "sourcePath": "tools/context-graph/src/cli.ts",
       "destinationPath": "src/interfaces/cli.ts",
       "sourceSha256": "c68f5f35a5325cc03811b0d4ffb6d58c31a9b4e6115fcb2c5e4fda9560a34714",
       "modified": true,
-      "destinationSha256": "21cdbc817983e788a5aac48ea8b32c55a7dda98868eb48b5df470c8d99eea44a"
+      "destinationSha256": "6d21bf3aa7890e3c16f89ff8619876e403ed84643f74af7813f8c1e289bce327"
     },
     {
       "sourcePath": "tools/context-graph/src/config.test.ts",
       "destinationPath": "src/configuration/config.test.ts",
       "sourceSha256": "70bcda6d6b48ff6fa03223c9420fe3e0e3e32c688e0a14f11034515e0707dee4",
       "modified": true,
-      "destinationSha256": "f9bedfd754d937023f7d06ff9a0fb8e9e4c9d122178446d2e70ac6914e184156"
+      "destinationSha256": "9ecbca0bcac760213208e4d40e3553c5ca8d994ef922d874ceaf57897978698b"
     },
     {
       "sourcePath": "tools/context-graph/src/config.ts",
       "destinationPath": "src/configuration/config.ts",
       "sourceSha256": "e9ee8cf2134d274aa6f6a21545959fbec97e958181d9032c073293f28e04d6ca",
       "modified": true,
-      "destinationSha256": "7c79bcd696102f89d3dcadaf01ab2311f68b37172b54b21a667de7f15bdec69a"
+      "destinationSha256": "29e606aff4311b6a717ee75b71a31a98a946d2547c383b2ed7aac3346cadae9d"
     },
     {
       "sourcePath": "tools/context-graph/src/core.ts",
@@ -283,7 +283,7 @@
       "destinationPath": "src/extraction/document.ts",
       "sourceSha256": "62a2da37d8cc0637b192b7e70ae7a0dce72244d335da9df0e0ad9b0eb7c4e1f1",
       "modified": true,
-      "destinationSha256": "1e9a5db4bf04455fa202d48fb20ac1de268d74179034cfcfa24d845cb4736bb3"
+      "destinationSha256": "535b92a52357edf4825414915b1109374f01cbc10ad7c0ed9c9b218452b8e18d"
     },
     {
       "sourcePath": "tools/context-graph/src/git.test.ts",
@@ -297,7 +297,7 @@
       "destinationPath": "src/repository/git.ts",
       "sourceSha256": "484d3986633bb32ccc3b665f2144007a213c303df51b375c1d653729921d6d2c",
       "modified": true,
-      "destinationSha256": "2557d47d1c54a6bbefc61d16eac4a4d16f995adadb480130ea39f558ce3522f1"
+      "destinationSha256": "769428b7dd480d7d288d7a04c1bea17628c58591ccb01e0f204e2d6f05a3ed6e"
     },
     {
       "sourcePath": "tools/context-graph/src/glob.ts",
@@ -318,14 +318,14 @@
       "destinationPath": "src/application/hydrator.ts",
       "sourceSha256": "bb41c5b53b26da10274d8b967b99c78ff12b485df16bfc66445252e35c94fb9d",
       "modified": true,
-      "destinationSha256": "ef6e21f322915b3bf25589d748f379becea5a0ef188bf875caaca10cc479cd2c"
+      "destinationSha256": "bcb8333b85808ce7382af0e4b91886225aca11bf24428ec5effdc760c165a6e4"
     },
     {
       "sourcePath": "tools/context-graph/src/index.ts",
       "destinationPath": "src/index.ts",
       "sourceSha256": "a3545649f67fc0bf0496298e3f1dca1e91aa7cb68ec112c34b99a5785fa83f3c",
       "modified": true,
-      "destinationSha256": "b185467e660715806fc914bef5db068e90199ee32b0226452d4adb4c09991d8b"
+      "destinationSha256": "56949ce41d06e88507d656f6b4f6ca1f06e34eeb41b081a621889382167d4b77"
     },
     {
       "sourcePath": "tools/context-graph/src/mcp-facade.ts",
@@ -388,14 +388,14 @@
       "destinationPath": "src/graph/query.test.ts",
       "sourceSha256": "ba07c52566da979fcbb451b0c0c99b466521993cb49415ff8b35df2b01d4ecaf",
       "modified": true,
-      "destinationSha256": "68d7405765dec5975370f79caaf8708db42dd3dd464a7ec9c3919c796ee81b79"
+      "destinationSha256": "7b6653f767c2e7445ec19f0cafc9d3fe97494ae139835ec63d335a7210e62c6c"
     },
     {
       "sourcePath": "tools/context-graph/src/query.ts",
       "destinationPath": "src/graph/query.ts",
       "sourceSha256": "4d67f87ca660cefe9686fb5b775f86a997a25d539819ea81d321c8bd1e0aaa39",
       "modified": true,
-      "destinationSha256": "0cf5bf085aa71180447e7d5b35a19eba6b3e8d87cef550b8bcb996022a7618d8"
+      "destinationSha256": "b5b19bddd2d51a1b33b45c9a625082e1774df983ec56c6a0ff4d0c076f1b40da"
     },
     {
       "sourcePath": "tools/context-graph/src/request.test.ts",
@@ -521,7 +521,7 @@
       "destinationPath": "src/visualization/visualization.ts",
       "sourceSha256": "4839a5cfbd0a97bf3d338e59eca752a9b96812b464c0369da93a55d209120ab7",
       "modified": true,
-      "destinationSha256": "e55328ba9957201c2152fcf036c8cd3eb9ce96fcbbdb93408ded2f5becd2f268"
+      "destinationSha256": "c7513a270e7513d3ec48b1bc3e19850a9a0199aa058c1151dd1e5c8f983e2adc"
     },
     {
       "sourcePath": "tools/context-graph/templates/context-graph-development/SKILL.md",
@@ -614,6 +614,12 @@
     "docs/ADR-019-semantic-failure-diagnostics.md",
     "docs/ADR-020-canonical-physical-file-producers.md",
     "docs/ADR-021-identity-preflight-and-validation-timing.md",
+    "docs/ADR-022-release-documentation.md",
+    "docs/ADR-023-document-coverage-preview.md",
+    "docs/ADR-024-implementation-coverage.md",
+    "docs/ADR-025-document-classification.md",
+    "docs/ADR-026-traversal-hydration.md",
+    "docs/ADR-027-validation-closeout.md",
     "docs/CLOUD-ENVIRONMENT.md",
     "docs/CONSUMER-TRIAL.md",
     "docs/ENVIRONMENT-VALIDATION.md",
@@ -629,6 +635,11 @@
     "docs/WEFTLET-2.0-PLAN.md",
     "docs/architecture-baseline.json",
     "docs/architecture-policy.md",
+    "docs/benchmarks/validation-2026-10-28/README.md",
+    "docs/benchmarks/validation-2026-10-28/large.json",
+    "docs/benchmarks/validation-2026-10-28/lifecycle.json",
+    "docs/benchmarks/validation-2026-10-28/native.json",
+    "docs/benchmarks/validation-2026-10-28/rich.json",
     "docs/extraction-manifest.json",
     "docs/licenses/REVIEW.md",
     "docs/licenses/lru-cache-11.5.3-BlueOak.md",
@@ -676,6 +687,7 @@
     "evaluations/weftlet/source-project-baseline.json",
     "evaluations/weftlet/source-project.config.json",
     "examples/generic-typescript/context-graph.oml.config.json",
+    "examples/generic-typescript/document-policy.json",
     "examples/pipeline/context-graph.config.json",
     "examples/pipeline/docs/admission.md",
     "examples/pipeline/docs/analysis.md",
@@ -732,17 +744,32 @@
     "scripts/record-release.mjs",
     "scripts/registry-publication.mjs",
     "scripts/registry-publication.test.ts",
+    "scripts/release-documentation.mjs",
+    "scripts/release-documentation.test.ts",
     "scripts/release-plan.mjs",
     "scripts/release-records.mjs",
     "scripts/release-records.test.ts",
     "scripts/release.mjs",
     "scripts/restore-publication-state.mjs",
+    "scripts/smoke-traversal.mjs",
     "scripts/update-inventory.mjs",
+    "scripts/validation-benchmark/execution.mjs",
+    "scripts/validation-benchmark/extracted.ts",
+    "scripts/validation-benchmark/inputs.mjs",
+    "scripts/validation-benchmark/measure.mjs",
+    "scripts/validation-benchmark/native.ts",
+    "scripts/validation-benchmark/run.mjs",
+    "scripts/validation-benchmark/study.test.ts",
+    "scripts/validation-benchmark/worker.mjs",
     "scripts/version-packages.mjs",
     "scripts/version-packages.test.ts",
     "src/application/cache-adoption.ts",
+    "src/application/document-classification.test.ts",
+    "src/application/document-coverage.ts",
+    "src/application/document-overlay.ts",
     "src/application/extraction-identity.ts",
     "src/application/hydration-failure.ts",
+    "src/application/hydration-inputs.ts",
     "src/application/hydration-plan.ts",
     "src/application/overlay.test.ts",
     "src/application/overlay.ts",
@@ -752,12 +779,21 @@
     "src/application/semantic-scope.ts",
     "src/cli.ts",
     "src/configuration/cache.test.ts",
+    "src/configuration/document-traversal.ts",
     "src/configuration/scip-project.ts",
+    "src/extraction/canonical-document-links.test.ts",
+    "src/extraction/canonical-document-links.ts",
     "src/extraction/codex-auth.test.ts",
     "src/extraction/codex-auth.ts",
     "src/extraction/codex-command.test.ts",
     "src/extraction/codex-command.ts",
+    "src/extraction/document-classification.test.ts",
+    "src/extraction/document-classification.ts",
+    "src/extraction/document-evidence.test.ts",
+    "src/extraction/document-evidence.ts",
     "src/extraction/document-references.ts",
+    "src/extraction/document-traversal.test.ts",
+    "src/extraction/document-traversal.ts",
     "src/extraction/document.test.ts",
     "src/extraction/module-request.test.ts",
     "src/extraction/module-request.ts",
@@ -779,6 +815,10 @@
     "src/governance/governance.ts",
     "src/governance/physical-file-kinds.test.ts",
     "src/graph/authority.ts",
+    "src/graph/coverage.test.ts",
+    "src/graph/coverage.ts",
+    "src/graph/document-role-description.ts",
+    "src/graph/document-roles.test.ts",
     "src/graph/identity-preflight.test.ts",
     "src/graph/identity-preflight.ts",
     "src/graph/ranking.test.ts",
@@ -789,6 +829,8 @@
     "src/infrastructure/module-resolution.ts",
     "src/interfaces/cache-adoption.test.ts",
     "src/interfaces/doctor.ts",
+    "src/interfaces/document-coverage.test.ts",
+    "src/interfaces/document-coverage.ts",
     "src/interfaces/hydration-failure.test.ts",
     "src/interfaces/hydration-plan.test.ts",
     "src/interfaces/identity-preflight.test.ts",
@@ -796,6 +838,7 @@
     "src/interfaces/init.ts",
     "src/mcp.ts",
     "src/repository/committed-tree.ts",
+    "src/repository/git-entries.test.ts",
     "src/repository/working-content.test.ts",
     "src/repository/working-content.ts",
     "src/storage/atomic-rename.test.ts",
@@ -804,10 +847,16 @@
     "src/visualization/viewer-interaction.ts",
     "tests/architecture.test.ts",
     "tests/cache-adoption.test.ts",
+    "tests/document-coverage.test.ts",
+    "tests/document-evidence.test.ts",
+    "tests/document-source-rdf.test.ts",
     "tests/extractor-compatibility.test.ts",
+    "tests/fixtures/shacl.ts",
+    "tests/fixtures/traversal.ts",
     "tests/hydration-failure.test.ts",
     "tests/hydration-plan.test.ts",
     "tests/identity-preflight.test.ts",
+    "tests/implementation-coverage.test.ts",
     "tests/module-boundaries.test.ts",
     "tests/physical-file-kinds.test.ts",
     "tests/rdf-ontology.test.ts",
@@ -817,7 +866,8 @@
     "tests/semantic-cache-reuse.test.ts",
     "tests/semantic-identity.test.ts",
     "tests/shacl-validation.test.ts",
-    "tests/snapshot-lifecycle.test.ts"
+    "tests/snapshot-lifecycle.test.ts",
+    "tests/traversal-hydration.test.ts"
   ],
   "publicationAuthorization": {
     "date": "2026-10-20",

package/examples/generic-typescript/document-policy.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": 1,
+  "roles": [
+    { "id": "search-intent", "pattern": "docs/search-capability.md", "role": "intent" }
+  ],
+  "owners": [
+    { "id": "search-owner", "pattern": "docs/search-capability.md", "ownerDocument": "docs/search-capability.md" }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weftlet/toolkit",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Evidence-backed context graphs for AI development agents: product intent, contracts, code, tests and runtime behavior",
   "license": "Apache-2.0",
   "type": "module",
@@ -63,7 +63,7 @@
     "n3": "2.7.2",
     "rdf-validate-shacl": "0.6.5",
     "sparqljs": "3.7.4",
-    "@weftlet/core": "^0.5.0"
+    "@weftlet/core": "^0.6.0"
   },
   "devDependencies": {
     "@changesets/cli": "3.0.3",
@@ -111,7 +111,9 @@
     "context-graph:licenses": "node scripts/generate-third-party-notices.mjs",
     "context-graph:licenses:check": "node scripts/generate-third-party-notices.mjs --check",
     "context-graph:pack:check": "node scripts/check-publication.mjs",
-    "context-graph:publication-check": "pnpm build && pnpm test && pnpm govern && pnpm inventory:check && pnpm context-graph:licenses:check && pnpm context-graph:pack:check",
+    "context-graph:publication-check": "pnpm docs:release:check && pnpm build && pnpm test && pnpm govern && pnpm inventory:check && pnpm context-graph:licenses:check && pnpm context-graph:pack:check",
+    "docs:release:check": "node scripts/release-documentation.mjs --check",
+    "docs:release:update": "node scripts/release-documentation.mjs --write",
     "inventory:update": "node scripts/update-inventory.mjs",
     "inventory:check": "node scripts/update-inventory.mjs --check",
     "release:prepare": "pnpm context-graph:publication-check && node scripts/release.mjs --prepare",
@@ -121,6 +123,7 @@
     "benchmark:shacl": "node scripts/benchmark-shacl.mjs",
     "weftlet": "tsx src/cli.ts",
     "changeset": "changeset",
-    "release:version": "node scripts/version-packages.mjs"
+    "release:version": "node scripts/version-packages.mjs",
+    "benchmark:validation": "node scripts/validation-benchmark/run.mjs"
   }
 }