@kungfu-tech/kfd 1.0.0-alpha.21 → 1.0.0-alpha.22

package/.buildchain/kfd-3/collaboration-interface.artifact.json

@@ -265,7 +265,7 @@
     {
       "id": "doc:readme",
       "sourcePath": "README.md",
-      "sha256": "c5a320a2d9e31972ae91b15310c003a9b6cc8c747ae72494514403abe925638d"
+      "sha256": "145bf51a3912089262e67a4c445743fbe538a438786768429dfb05e9e8246a08"
     },
     {
       "id": "doc:trademarks",
@@ -275,12 +275,12 @@
     {
       "id": "doc:docs-map",
       "sourcePath": "docs/MAP.md",
-      "sha256": "249e0d188993906aca3e0538c236e3b74fe90474dac34234d6ae83659f0627cf"
+      "sha256": "cbc48a98c58c85e4899526ed810c3ff20a4694e856c067a245d23d16527c9378"
     },
     {
       "id": "doc:kfd-1-usage",
       "sourcePath": "docs/KFD-1-usage.md",
-      "sha256": "3b9691cdd9c0a28c1e428e1cb421939cb17deab37d99c39caff13c058c63846a"
+      "sha256": "018cf16c950c485af813826ba19485b58a09e6f00a8e5852fc09fff355d848b6"
     },
     {
       "id": "doc:kfd-2-usage",
@@ -300,7 +300,7 @@
     {
       "id": "decision:kfd-1",
       "sourcePath": "decisions/KFD-1.md",
-      "sha256": "0b7b1ec54d661b271f91f02cefa97b11e1d1ef9c637efd2d1878d5f9c9185d80"
+      "sha256": "dcc97d2e24ffc8f0380cd027ba973bf8268cff59fa9ab766b178e894bcf1f164"
     },
     {
       "id": "decision:kfd-2",
@@ -384,17 +384,17 @@
     {
       "id": "metadata:standards",
       "sourcePath": "standards.json",
-      "sha256": "4ee9e5fc732eef1b43c75a146125496e0dbd859ef5a11d0c637c41e9091c677f"
+      "sha256": "de9f5b53cde78460f3794c65b6921a5de7186179f02200778bf3f7543beee343"
     },
     {
       "id": "metadata:release-impact",
       "sourcePath": "release-impact.json",
-      "sha256": "685f65d10491593d28321431eee315bb5fbbedd2d1ccec0747f4a37547b3124a"
+      "sha256": "95a11d50b963e9b5655b3ad0dbbe47baae6e6cf425b0e46c16a00e294bae12fb"
     },
     {
       "id": "metadata:release-anchor",
       "sourcePath": "kfd.release.json",
-      "sha256": "bfb302c839b6cb45204d541b5af5b1c211568efb16fb3eebbb04dc65f7de83d2"
+      "sha256": "20000792307af18effba3337d5fd9f2dfdf06898f08560888200377b048cf9d7"
     },
     {
       "id": "metadata:buildchain-contract-lock",
@@ -404,36 +404,36 @@
     {
       "id": "metadata:kfd-2-public-release-trust-claim",
       "sourcePath": ".buildchain/kfd-2/public-release-trust.claim.json",
-      "sha256": "3780b47472762b5ce9575250da73ee800af71dd194a9b0a3f61a063569311237"
+      "sha256": "9db0969b8fae77cfd9748d4b54f8c6030ce56e4e5605a8af9c0b65cdeba84d7b"
     },
     {
       "id": "metadata:kfd-2-foundation-trust-claims",
       "sourcePath": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
-      "sha256": "87757bd26c8f64465472aaafda05fe56497939a3ce66274563c142594d9d769b"
+      "sha256": "198f6b081cdd8b2901cfa8bd5de480e2ec7d194d9b309ea215862128e030f0bc"
     },
     {
       "id": "metadata:kfd-2-foundation-trust-assessment",
       "sourcePath": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
-      "sha256": "c3749585bb4a295bb2f0f510a4b6030f0398d9a09dc50dab0ace31248bf95b0f"
+      "sha256": "b1b8acca5df17f4c34fb7c5eacda26f25192f8f8a74d1d0d10f75e2b7aaee9ea"
     }
   ],
   "packageExports": [
     {
       "id": "export:package-json",
       "sourcePath": "package.json#exports",
-      "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534"
+      "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e"
     },
     {
       "id": "export:npm-files",
       "sourcePath": "package.json#files",
-      "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534"
+      "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e"
     }
   ],
   "siteConsumptionContracts": [
     {
       "id": "site:kfd-site-bundle",
       "sourcePath": "site/kfd-site.json",
-      "sha256": "bb0c8f27239d8716eda2fcb730b7933a9df580da0be0c415d6f42262d34d1709"
+      "sha256": "9427781d9a7bea6d8cf1a93bd43b60d6d48645b8eb9c9b18425feb2d9ee50ec5"
     },
     {
       "id": "site:release-propagation",
@@ -445,12 +445,12 @@
     "minimalEntrypoints": [
       {
         "path": "README.md",
-        "sha256": "c5a320a2d9e31972ae91b15310c003a9b6cc8c747ae72494514403abe925638d",
+        "sha256": "145bf51a3912089262e67a4c445743fbe538a438786768429dfb05e9e8246a08",
         "description": "Start from the KFD worldview and current decision set."
       },
       {
         "path": "docs/MAP.md",
-        "sha256": "249e0d188993906aca3e0538c236e3b74fe90474dac34234d6ae83659f0627cf",
+        "sha256": "cbc48a98c58c85e4899526ed810c3ff20a4694e856c067a245d23d16527c9378",
         "description": "Route readers and agents to the right KFD document or machine surface."
       },
       {
@@ -465,44 +465,44 @@
       },
       {
         "path": "standards.json",
-        "sha256": "4ee9e5fc732eef1b43c75a146125496e0dbd859ef5a11d0c637c41e9091c677f",
+        "sha256": "de9f5b53cde78460f3794c65b6921a5de7186179f02200778bf3f7543beee343",
         "description": "Discover KFD schema IDs, schema paths, concepts, and interface contracts."
       },
       {
         "path": "package.json#exports",
-        "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534",
+        "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e",
         "description": "Consume the shipped npm package surfaces."
       },
       {
         "path": "kfd.release.json",
-        "sha256": "bfb302c839b6cb45204d541b5af5b1c211568efb16fb3eebbb04dc65f7de83d2",
+        "sha256": "20000792307af18effba3337d5fd9f2dfdf06898f08560888200377b048cf9d7",
         "description": "Inspect the explicit KFD package version anchor for the current Buildchain release line."
       },
       {
         "path": ".buildchain/kfd-2/public-release-trust.claim.json",
-        "sha256": "3780b47472762b5ce9575250da73ee800af71dd194a9b0a3f61a063569311237",
+        "sha256": "9db0969b8fae77cfd9748d4b54f8c6030ce56e4e5605a8af9c0b65cdeba84d7b",
         "description": "Inspect the explicit public KFD-2 claim passed into Buildchain release passport generation."
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
-        "sha256": "87757bd26c8f64465472aaafda05fe56497939a3ce66274563c142594d9d769b",
+        "sha256": "198f6b081cdd8b2901cfa8bd5de480e2ec7d194d9b309ea215862128e030f0bc",
         "description": "Inspect generic KFD-2 claims for the KFD package self-dogfood assessment."
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
-        "sha256": "c3749585bb4a295bb2f0f510a4b6030f0398d9a09dc50dab0ace31248bf95b0f",
+        "sha256": "b1b8acca5df17f4c34fb7c5eacda26f25192f8f8a74d1d0d10f75e2b7aaee9ea",
         "description": "Inspect KFD-2's generic assessment of KFD-1, KFD-3, and KFD-4 claims."
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "bb0c8f27239d8716eda2fcb730b7933a9df580da0be0c415d6f42262d34d1709",
+        "sha256": "9427781d9a7bea6d8cf1a93bd43b60d6d48645b8eb9c9b18425feb2d9ee50ec5",
         "description": "Render KFD-owned site text and decision pages without duplicating extraction logic."
       }
     ],
     "discoverability": [
       {
         "path": "README.md",
-        "sha256": "c5a320a2d9e31972ae91b15310c003a9b6cc8c747ae72494514403abe925638d",
+        "sha256": "145bf51a3912089262e67a4c445743fbe538a438786768429dfb05e9e8246a08",
         "description": "Human and agent entrypoint"
       },
       {
@@ -512,7 +512,7 @@
       },
       {
         "path": "docs/MAP.md",
-        "sha256": "249e0d188993906aca3e0538c236e3b74fe90474dac34234d6ae83659f0627cf",
+        "sha256": "cbc48a98c58c85e4899526ed810c3ff20a4694e856c067a245d23d16527c9378",
         "description": "Documentation routing entrypoint"
       },
       {
@@ -522,44 +522,44 @@
       },
       {
         "path": "standards.json",
-        "sha256": "4ee9e5fc732eef1b43c75a146125496e0dbd859ef5a11d0c637c41e9091c677f",
+        "sha256": "de9f5b53cde78460f3794c65b6921a5de7186179f02200778bf3f7543beee343",
         "description": "Machine-readable standards metadata"
       },
       {
         "path": ".buildchain/kfd-2/public-release-trust.claim.json",
-        "sha256": "3780b47472762b5ce9575250da73ee800af71dd194a9b0a3f61a063569311237",
+        "sha256": "9db0969b8fae77cfd9748d4b54f8c6030ce56e4e5605a8af9c0b65cdeba84d7b",
         "description": "KFD-2 public release trust claim"
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
-        "sha256": "87757bd26c8f64465472aaafda05fe56497939a3ce66274563c142594d9d769b",
+        "sha256": "198f6b081cdd8b2901cfa8bd5de480e2ec7d194d9b309ea215862128e030f0bc",
         "description": "KFD-2 generic trust claims for KFD self-dogfood"
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
-        "sha256": "c3749585bb4a295bb2f0f510a4b6030f0398d9a09dc50dab0ace31248bf95b0f",
+        "sha256": "b1b8acca5df17f4c34fb7c5eacda26f25192f8f8a74d1d0d10f75e2b7aaee9ea",
         "description": "KFD-2 generic trust assessment for KFD self-dogfood"
       },
       {
         "path": "package.json",
-        "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534",
+        "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e",
         "description": "Package export map"
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "bb0c8f27239d8716eda2fcb730b7933a9df580da0be0c415d6f42262d34d1709",
+        "sha256": "9427781d9a7bea6d8cf1a93bd43b60d6d48645b8eb9c9b18425feb2d9ee50ec5",
         "description": "Site content projection"
       }
     ],
     "valueEvidence": [
       {
         "path": "README.md",
-        "sha256": "c5a320a2d9e31972ae91b15310c003a9b6cc8c747ae72494514403abe925638d",
+        "sha256": "145bf51a3912089262e67a4c445743fbe538a438786768429dfb05e9e8246a08",
         "description": "KFD-3 value evidence for kfd-foundation-model: KFD helps humans and agents understand the foundation model before adopting or extending kungfu-systems decisions."
       },
       {
         "path": "decisions/KFD-1.md",
-        "sha256": "0b7b1ec54d661b271f91f02cefa97b11e1d1ef9c637efd2d1878d5f9c9185d80",
+        "sha256": "dcc97d2e24ffc8f0380cd027ba973bf8268cff59fa9ab766b178e894bcf1f164",
         "description": "KFD-3 value evidence for kfd-foundation-model: KFD helps humans and agents understand the foundation model before adopting or extending kungfu-systems decisions."
       },
       {
@@ -579,22 +579,22 @@
       },
       {
         "path": "standards.json",
-        "sha256": "4ee9e5fc732eef1b43c75a146125496e0dbd859ef5a11d0c637c41e9091c677f",
+        "sha256": "de9f5b53cde78460f3794c65b6921a5de7186179f02200778bf3f7543beee343",
         "description": "KFD-3 value evidence for kfd-foundation-model: KFD helps humans and agents understand the foundation model before adopting or extending kungfu-systems decisions."
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "bb0c8f27239d8716eda2fcb730b7933a9df580da0be0c415d6f42262d34d1709",
+        "sha256": "9427781d9a7bea6d8cf1a93bd43b60d6d48645b8eb9c9b18425feb2d9ee50ec5",
         "description": "KFD-3 value evidence for kfd-foundation-model: KFD helps humans and agents understand the foundation model before adopting or extending kungfu-systems decisions."
       },
       {
         "path": "scripts/check.mjs",
-        "sha256": "531fec64c2d570c8214bc2009569ccff4436bbabbff9a54cf5220d2c323fc974",
+        "sha256": "a9b277e6fe5ff0ed276ff169b3eac7734455f148ae4ad33657126dca309a3899",
         "description": "KFD-3 value evidence for kfd-foundation-model: KFD helps humans and agents understand the foundation model before adopting or extending kungfu-systems decisions."
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
-        "sha256": "c3749585bb4a295bb2f0f510a4b6030f0398d9a09dc50dab0ace31248bf95b0f",
+        "sha256": "b1b8acca5df17f4c34fb7c5eacda26f25192f8f8a74d1d0d10f75e2b7aaee9ea",
         "description": "KFD-3 value evidence for kfd-foundation-model: KFD helps humans and agents understand the foundation model before adopting or extending kungfu-systems decisions."
       },
       {
@@ -609,12 +609,12 @@
       },
       {
         "path": "package.json#exports",
-        "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534",
+        "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e",
         "description": "KFD-3 value evidence for kfd-machine-consumption: KFD gives agents and release systems machine-readable standards, schemas, package exports, and witnesses so they can consume KFD without relying on private context."
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
-        "sha256": "87757bd26c8f64465472aaafda05fe56497939a3ce66274563c142594d9d769b",
+        "sha256": "198f6b081cdd8b2901cfa8bd5de480e2ec7d194d9b309ea215862128e030f0bc",
         "description": "KFD-3 value evidence for kfd-machine-consumption: KFD gives agents and release systems machine-readable standards, schemas, package exports, and witnesses so they can consume KFD without relying on private context."
       },
       {
@@ -651,19 +651,19 @@
       },
       {
         "path": "scripts/check.mjs",
-        "sha256": "531fec64c2d570c8214bc2009569ccff4436bbabbff9a54cf5220d2c323fc974",
+        "sha256": "a9b277e6fe5ff0ed276ff169b3eac7734455f148ae4ad33657126dca309a3899",
         "description": "Repository self-verification gate"
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "bb0c8f27239d8716eda2fcb730b7933a9df580da0be0c415d6f42262d34d1709",
+        "sha256": "9427781d9a7bea6d8cf1a93bd43b60d6d48645b8eb9c9b18425feb2d9ee50ec5",
         "description": "Site rendering boundary"
       }
     ],
     "choicePaths": [
       {
         "path": "README.md",
-        "sha256": "c5a320a2d9e31972ae91b15310c003a9b6cc8c747ae72494514403abe925638d",
+        "sha256": "145bf51a3912089262e67a4c445743fbe538a438786768429dfb05e9e8246a08",
         "description": "Human reading path"
       },
       {
@@ -673,34 +673,34 @@
       },
       {
         "path": "standards.json",
-        "sha256": "4ee9e5fc732eef1b43c75a146125496e0dbd859ef5a11d0c637c41e9091c677f",
+        "sha256": "de9f5b53cde78460f3794c65b6921a5de7186179f02200778bf3f7543beee343",
         "description": "Agent standards metadata path"
       },
       {
         "path": ".buildchain/kfd-2/public-release-trust.claim.json",
-        "sha256": "3780b47472762b5ce9575250da73ee800af71dd194a9b0a3f61a063569311237",
+        "sha256": "9db0969b8fae77cfd9748d4b54f8c6030ce56e4e5605a8af9c0b65cdeba84d7b",
         "description": "Agent release trust claim path"
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
-        "sha256": "87757bd26c8f64465472aaafda05fe56497939a3ce66274563c142594d9d769b",
+        "sha256": "198f6b081cdd8b2901cfa8bd5de480e2ec7d194d9b309ea215862128e030f0bc",
         "description": "Agent generic trust claims path"
       },
       {
         "path": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
-        "sha256": "c3749585bb4a295bb2f0f510a4b6030f0398d9a09dc50dab0ace31248bf95b0f",
+        "sha256": "b1b8acca5df17f4c34fb7c5eacda26f25192f8f8a74d1d0d10f75e2b7aaee9ea",
         "description": "Agent generic trust assessment path"
       },
       {
         "path": "package.json",
-        "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534",
+        "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e",
         "description": "Package consumption path"
       }
     ],
     "manuals": [
       {
         "path": "docs/MAP.md",
-        "sha256": "249e0d188993906aca3e0538c236e3b74fe90474dac34234d6ae83659f0627cf"
+        "sha256": "cbc48a98c58c85e4899526ed810c3ff20a4694e856c067a245d23d16527c9378"
       },
       {
         "path": "TRADEMARKS.md",
@@ -708,7 +708,7 @@
       },
       {
         "path": "docs/KFD-1-usage.md",
-        "sha256": "3b9691cdd9c0a28c1e428e1cb421939cb17deab37d99c39caff13c058c63846a"
+        "sha256": "018cf16c950c485af813826ba19485b58a09e6f00a8e5852fc09fff355d848b6"
       },
       {
         "path": "docs/KFD-2-usage.md",

package/.buildchain/kfd-3/collaboration-interface.prebuild.json

@@ -924,7 +924,7 @@
     {
       "id": "doc:readme",
       "sourcePath": "README.md",
-      "sha256": "c5a320a2d9e31972ae91b15310c003a9b6cc8c747ae72494514403abe925638d"
+      "sha256": "145bf51a3912089262e67a4c445743fbe538a438786768429dfb05e9e8246a08"
     },
     {
       "id": "doc:trademarks",
@@ -934,12 +934,12 @@
     {
       "id": "doc:docs-map",
       "sourcePath": "docs/MAP.md",
-      "sha256": "249e0d188993906aca3e0538c236e3b74fe90474dac34234d6ae83659f0627cf"
+      "sha256": "cbc48a98c58c85e4899526ed810c3ff20a4694e856c067a245d23d16527c9378"
     },
     {
       "id": "doc:kfd-1-usage",
       "sourcePath": "docs/KFD-1-usage.md",
-      "sha256": "3b9691cdd9c0a28c1e428e1cb421939cb17deab37d99c39caff13c058c63846a"
+      "sha256": "018cf16c950c485af813826ba19485b58a09e6f00a8e5852fc09fff355d848b6"
     },
     {
       "id": "doc:kfd-2-usage",
@@ -959,7 +959,7 @@
     {
       "id": "decision:kfd-1",
       "sourcePath": "decisions/KFD-1.md",
-      "sha256": "0b7b1ec54d661b271f91f02cefa97b11e1d1ef9c637efd2d1878d5f9c9185d80"
+      "sha256": "dcc97d2e24ffc8f0380cd027ba973bf8268cff59fa9ab766b178e894bcf1f164"
     },
     {
       "id": "decision:kfd-2",
@@ -1043,17 +1043,17 @@
     {
       "id": "metadata:standards",
       "sourcePath": "standards.json",
-      "sha256": "4ee9e5fc732eef1b43c75a146125496e0dbd859ef5a11d0c637c41e9091c677f"
+      "sha256": "de9f5b53cde78460f3794c65b6921a5de7186179f02200778bf3f7543beee343"
     },
     {
       "id": "metadata:release-impact",
       "sourcePath": "release-impact.json",
-      "sha256": "685f65d10491593d28321431eee315bb5fbbedd2d1ccec0747f4a37547b3124a"
+      "sha256": "95a11d50b963e9b5655b3ad0dbbe47baae6e6cf425b0e46c16a00e294bae12fb"
     },
     {
       "id": "metadata:release-anchor",
       "sourcePath": "kfd.release.json",
-      "sha256": "bfb302c839b6cb45204d541b5af5b1c211568efb16fb3eebbb04dc65f7de83d2"
+      "sha256": "20000792307af18effba3337d5fd9f2dfdf06898f08560888200377b048cf9d7"
     },
     {
       "id": "metadata:buildchain-contract-lock",
@@ -1063,36 +1063,36 @@
     {
       "id": "metadata:kfd-2-public-release-trust-claim",
       "sourcePath": ".buildchain/kfd-2/public-release-trust.claim.json",
-      "sha256": "3780b47472762b5ce9575250da73ee800af71dd194a9b0a3f61a063569311237"
+      "sha256": "9db0969b8fae77cfd9748d4b54f8c6030ce56e4e5605a8af9c0b65cdeba84d7b"
     },
     {
       "id": "metadata:kfd-2-foundation-trust-claims",
       "sourcePath": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
-      "sha256": "87757bd26c8f64465472aaafda05fe56497939a3ce66274563c142594d9d769b"
+      "sha256": "198f6b081cdd8b2901cfa8bd5de480e2ec7d194d9b309ea215862128e030f0bc"
     },
     {
       "id": "metadata:kfd-2-foundation-trust-assessment",
       "sourcePath": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
-      "sha256": "c3749585bb4a295bb2f0f510a4b6030f0398d9a09dc50dab0ace31248bf95b0f"
+      "sha256": "b1b8acca5df17f4c34fb7c5eacda26f25192f8f8a74d1d0d10f75e2b7aaee9ea"
     }
   ],
   "packageExports": [
     {
       "id": "export:package-json",
       "sourcePath": "package.json#exports",
-      "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534"
+      "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e"
     },
     {
       "id": "export:npm-files",
       "sourcePath": "package.json#files",
-      "sha256": "7773f62e7789220a9e21abe9626e7206028a2dc5de59e836595bd07be9459534"
+      "sha256": "8777774ecb354854b863fddb036544a989712d091168f6a34e4b41267621ab1e"
     }
   ],
   "siteConsumptionContracts": [
     {
       "id": "site:kfd-site-bundle",
       "sourcePath": "site/kfd-site.json",
-      "sha256": "bb0c8f27239d8716eda2fcb730b7933a9df580da0be0c415d6f42262d34d1709"
+      "sha256": "9427781d9a7bea6d8cf1a93bd43b60d6d48645b8eb9c9b18425feb2d9ee50ec5"
     },
     {
       "id": "site:release-propagation",

package/README.md

@@ -185,7 +185,10 @@ Agents consuming this package should start from the same sources as humans:
    KFD-2 assessment instead of a release-specific passport.
 6. Use `schemas/kfd-3/collaboration-interface.schema.json` and
    `schemas/kfd-3/witness.schema.json` to inspect collaboration interfaces.
-7. If a needed KFD-2 taxonomy value is missing, open a KFD GitHub issue rather
+7. Use `schemas/kfd-1/publication-url-semantics.schema.json` when a package,
+   paper, specification, or site bundle must distinguish stable reader URLs,
+   latest aliases, and immutable versioned artifacts.
+8. If a needed KFD-2 taxonomy value is missing, open a KFD GitHub issue rather
    than inventing a local value:
    `https://github.com/kungfu-systems/kfd/issues/new?title=KFD-2%20trust%20taxonomy%20extension%20request`.
 

package/decisions/KFD-1.md

@@ -29,8 +29,10 @@ they are integrating with, replaying, auditing, or trusting.
 KFD-1 has concrete implementation surfaces across the Kungfu ecosystem:
 versioning protects release lines from contract drift, config contracts protect
 multi-target configuration from drifting across runtimes, products, and
-agent-facing surfaces, and KFD metadata protects the decision package's own
-standard surfaces from drifting away from their declared source.
+agent-facing surfaces, publication URL semantics protect released documents and
+evidence from drifting across site rebuilds, and KFD metadata protects the
+decision package's own standard surfaces from drifting away from their declared
+source.
 
 ## Premise: the welded-surface register
 
@@ -63,6 +65,31 @@ steps, and the final product must consume the same contract mechanism. It is
 not enough for the packaged artifact to be internally consistent if the
 developer path used a different, driftable config source.
 
+## Concrete case: publication URL semantics
+
+A public paper, specification, or long-lived document often needs two route
+classes at the same time:
+
+- a **stable reader entrypoint**, such as a product page or canonical paper
+  URL, which may point readers to the current recommended version; and
+- an **immutable version entrypoint**, where the released PDF, source bundle,
+  release passport, site bundle, registry entry, or other evidence for one
+  version remains content-addressed and does not change after publication.
+
+Those routes are welded surfaces. A site repository may render the current
+page from the latest upstream package, but it must not become the only place
+where historical artifacts live. The historical artifact fact must remain in
+an archive or release registry whose versioned URL and digest do not drift.
+Mutable pages may move; immutable version artifacts must not.
+
+The KFD-owned interface for this case is
+`schemas/kfd-1/publication-url-semantics.schema.json`. It defines the generic
+vocabulary for `canonicalUrl`, `latestUrl`, `immutableVersionBaseUrl`,
+artifact digests, source coordinates, lineage, and the archive policy that
+forbids same-version digest changes or destructive sync over immutable
+prefixes. Concrete repositories own their routes and storage layout; KFD owns
+the semantics that make those declarations auditable.
+
 ## The compatibility impact core
 
 Classify the actual diff against the register; the strongest match wins:

package/docs/KFD-1-usage.md

@@ -12,6 +12,9 @@ The KFD package implements KFD-1 through a declared contract world:
   surface register.
 - `schemas/kfd-1/contract-world.schema.json` defines the contract-world schema.
 - `schemas/kfd-1/witness.schema.json` defines the witness schema.
+- `schemas/kfd-1/publication-url-semantics.schema.json` defines the
+  canonical/latest/immutable publication URL contract for papers,
+  specifications, release notes, and other long-lived publication artifacts.
 - `.buildchain/kfd-1/contract-world.witness.json` projects registered surfaces,
   source hashes, artifact hashes, surface classes, and impact projections.
 - `scripts/check.mjs` verifies the register, schema enums, witness hashes, and
@@ -30,6 +33,45 @@ Release versioning is only one projection of those classes. Other domains can
 project the same core into config migration, ABI epochs, API namespaces,
 runtime compatibility bridges, or workflow gates.
 
+## Publication URL Semantics
+
+Publication artifacts frequently need both mutable and immutable routes. A
+canonical reader page may remain stable while its content is updated to point
+at the latest recommended version. A versioned PDF, source bundle, release
+passport, publication registry entry, or site bundle is different: once
+published, the versioned URL and digest are facts that downstream readers,
+agents, release passports, citations, and audits may weld to.
+
+The KFD-1 publication URL schema gives Buildchain and site repositories a
+shared vocabulary:
+
+- `canonicalUrl`: stable reader entrypoint; it may display the latest
+  recommended version.
+- `latestUrl`: mutable latest alias or evidence entrypoint; it may move when a
+  new version is published.
+- `immutableVersionBaseUrl`: version-addressed archive prefix; its published
+  artifacts must not change content.
+- `immutableArtifacts[]`: digest-bound artifacts such as PDF, source bundle,
+  release passport, site bundle, or publication registry entry.
+- `sourceCoordinate`: repository commit, tag, source bundle, release passport,
+  or equivalent coordinate for the source fact.
+- `archivePolicy`: the rule that same-version digest drift fails, destructive
+  sync must not cover immutable prefixes, and site builds must preserve
+  declared historical versions.
+
+KFD does not choose bucket names, CDN providers, product slugs, or exact route
+layout. Concrete packages declare those facts in their own site bundle or
+Buildchain release metadata. KFD owns the route semantics so those facts can be
+validated consistently.
+
+This connects the foundation triad:
+
+- KFD-1: the immutable artifact URL and digest must not drift.
+- KFD-2: trust in the publication starts from version, digest, source
+  coordinate, release passport, and archive location.
+- KFD-3: site renderers and agents should see the route facts instead of
+  reverse-engineering or forking them locally.
+
 ## Dogfood Role
 
 This package uses KFD-1 on itself. New public package surfaces should be added

package/docs/MAP.md

@@ -9,6 +9,7 @@
 | How should a product show timeline order from a declared perspective? | [KFD-4](../decisions/KFD-4.md) |
 | What schema should products use for KFD-4 observer-relative timeline views? | [`../schemas/kfd-4/observer-perspective.schema.json`](../schemas/kfd-4/observer-perspective.schema.json) |
 | What are the package implementation notes for KFD-1? | [`KFD-1-usage.md`](KFD-1-usage.md) |
+| What schema should papers, specifications, or sites use for canonical/latest/immutable publication URL semantics? | [`../schemas/kfd-1/publication-url-semantics.schema.json`](../schemas/kfd-1/publication-url-semantics.schema.json) and [`KFD-1-usage.md`](KFD-1-usage.md#publication-url-semantics) |
 | What are the package implementation notes for KFD-2? | [`KFD-2-usage.md`](KFD-2-usage.md) |
 | What are the package implementation notes for KFD-3? | [`KFD-3-usage.md`](KFD-3-usage.md) |
 | What are the package implementation notes for KFD-4? | [`KFD-4-usage.md`](KFD-4-usage.md) |

package/kfd.release.json

@@ -4,7 +4,7 @@
   "line": "v1.0",
   "channel": "alpha",
   "npmPackage": "@kungfu-tech/kfd",
-  "npmVersion": "1.0.0-alpha.21",
+  "npmVersion": "1.0.0-alpha.22",
   "source": {
     "repository": "kungfu-systems/kfd",
     "branch": "alpha/v1/v1.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungfu-tech/kfd",
-  "version": "1.0.0-alpha.21",
+  "version": "1.0.0-alpha.22",
   "description": "Kung Fu Decisions (KFD): the kungfu-systems organization-wide decision registry, as a consumable artifact",
   "license": "Apache-2.0",
   "files": [

package/release-impact.json

@@ -8,8 +8,8 @@
   },
   "versionImpact": {
     "final": "minor",
-    "source": "kfd-site-decision-usage-pages",
-    "rationale": "This change additively exposes decision usage subpage mapping in the KFD site bundle, while preserving existing registry, package, and schemaVersion 1 compatibility."
+    "source": "kfd-1-publication-url-semantics",
+    "rationale": "This change additively exposes KFD-1 publication URL semantics for canonical/latest/immutable publication routes, while preserving existing registry, package, and schemaVersion 1 compatibility."
   },
   "surfaceImpacts": [
     {
@@ -107,7 +107,13 @@
       "impact": "minor",
       "class": "additive",
       "rationale": "standards.json now publishes the KFD package surface register as the KFD-1 fact source, and the KFD-1 witness projects each registered surface class and impact projection from that fact source."
+    },
+    {
+      "id": "kfd-1-publication-url-semantics",
+      "impact": "minor",
+      "class": "additive",
+      "rationale": "KFD-1 now publishes a machine-readable schema for canonical reader URLs, latest aliases, immutable version artifact URLs, artifact digests, source coordinates, lineage, site consumption, and archive policies that prevent same-version digest drift or destructive deletion of immutable publication prefixes."
     }
   ],
-  "summary": "KFD v1.0 production promotion is minor-impact because it additively exposes decision usage subpage mapping in the site bundle, preserves existing package and schemaVersion 1 compatibility, and separates authoritative decision paths from numbered usage documentation."
+  "summary": "KFD v1.0 production promotion is minor-impact because it additively exposes publication URL semantics and related machine metadata while preserving existing package and schemaVersion 1 compatibility."
 }