@kungfu-tech/kfd 1.0.0-alpha.12 → 1.0.0-alpha.13

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

@@ -5,17 +5,17 @@
   "standard": "kfd-3",
   "collaborationInterface": {
     "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-3/collaboration-interface.schema.json",
-    "digest": "sha256:866fc1f20fe3a4084c31f2edf98e270dd5f7c5bf2801a67e57335daaefa3dd2e"
+    "digest": "sha256:e32f2196399d37db202ccc656386bddc346871243c3db6782d26b5a88f831595"
   },
   "sourceRegistry": {
     "id": "kfd-collaboration-interface",
     "path": ".buildchain/kfd-3/collaboration-interface.json",
-    "sha256": "866fc1f20fe3a4084c31f2edf98e270dd5f7c5bf2801a67e57335daaefa3dd2e"
+    "sha256": "e32f2196399d37db202ccc656386bddc346871243c3db6782d26b5a88f831595"
   },
   "artifact": {
     "name": "@kungfu-tech/kfd",
     "path": "npm:@kungfu-tech/kfd",
-    "digest": "sha256:866fc1f20fe3a4084c31f2edf98e270dd5f7c5bf2801a67e57335daaefa3dd2e"
+    "digest": "sha256:e32f2196399d37db202ccc656386bddc346871243c3db6782d26b5a88f831595"
   },
   "surfaces": [
     {
@@ -40,6 +40,17 @@
       "public": true,
       "sourcePath": "docs/MAP.md"
     },
+    {
+      "id": "official-status-and-trademarks",
+      "name": "official-status-and-trademarks",
+      "kind": "markdown-doc",
+      "participantProfile": "human-reader,agent-reader,package-consumer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "TRADEMARKS.md"
+    },
     {
       "id": "decision-texts",
       "name": "decision-texts",
@@ -232,37 +243,42 @@
     {
       "id": "doc:readme",
       "sourcePath": "README.md",
-      "sha256": "f158b84881e44f32758b3ff0cc165f478bc1ab6596ad16fe941caeb51573a536"
+      "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b"
+    },
+    {
+      "id": "doc:trademarks",
+      "sourcePath": "TRADEMARKS.md",
+      "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1"
     },
     {
       "id": "doc:docs-map",
       "sourcePath": "docs/MAP.md",
-      "sha256": "8d4d498a737aa7e3cf490653bcd1d13bc32dc057b3d322ff4a84b25f31aae47b"
+      "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d"
     },
     {
       "id": "doc:kfd-2-release-trust",
       "sourcePath": "docs/kfd-2-release-trust.md",
-      "sha256": "90326ac403339d73cb4d3bf8a0d2e6ca33ff0988809bbc71c163cb459861ad5c"
+      "sha256": "9ba323334750cf285f08de21286f58c04b872189febf38a4e8fd50c0791020b3"
     },
     {
       "id": "doc:kfd-3-collaboration-interface",
       "sourcePath": "docs/kfd-3-collaboration-interface.md",
-      "sha256": "63263cf25cca617ec51595b3f46ac2af541794449cfd34b3042ff657dcd7838a"
+      "sha256": "d483ff6f8423a2e3f8e5dc547b62139d5c365678f9974d62063f8b523f14edb0"
     },
     {
       "id": "decision:kfd-1",
       "sourcePath": "decisions/kfd-1.md",
-      "sha256": "2ef7438b0737009d36da248d2ecec5f788d46a93b184efadf5e2e31ca20254f0"
+      "sha256": "32016c0962edcea9286db04ba24dab6c55400e9b26ce16a9d4b4ad647e17e7df"
     },
     {
       "id": "decision:kfd-2",
       "sourcePath": "decisions/kfd-2.md",
-      "sha256": "b8be7b7526dcec9ea501998056c55f546492abc4eb63484a9bb8856eb434b710"
+      "sha256": "0c2da2113df6ef2829592f7ba67593059cb06e195ea527ee742501939efb3b9b"
     },
     {
       "id": "decision:kfd-3",
       "sourcePath": "decisions/kfd-3.md",
-      "sha256": "e329bef41ab5cb689346333df317b39918ea1016424a872e438eea8090070b96"
+      "sha256": "f37320562b6d82630358663acc239a3ee84bdc930b287c6cb0b2fb0295110672"
     }
   ],
   "schemas": [
@@ -281,71 +297,76 @@
       "sourcePath": "schemas/kfd-1/witness.schema.json",
       "sha256": "50104a2962cb75cc1da634fa65553e993f87d8fb9b3c237f0609a2208ad4c1f3"
     },
+    {
+      "id": "schema:kfd-2:trust-taxonomy",
+      "sourcePath": "schemas/kfd-2/trust-taxonomy.schema.json",
+      "sha256": "a663d301a663cadb8567e3010361f5a630b76b6518ed7603dfd58cbd4e64a658"
+    },
     {
       "id": "schema:kfd-2:release-claims",
       "sourcePath": "schemas/kfd-2/release-claims.schema.json",
-      "sha256": "cf90ef7d0a7c2abc33af0d97d793b7e9c3ed96335da0b79a082523139282963e"
+      "sha256": "0f52c4a9949f62163a0fbe14fefc2f2f93f548ae18b6b5c07eb87aedca4c0be0"
     },
     {
       "id": "schema:kfd-2:release-trust-passport",
       "sourcePath": "schemas/kfd-2/release-trust-passport.schema.json",
-      "sha256": "92bdd34c0575d18240d1c8be12e86034209f54819048ead9617e7aa2e539aaef"
+      "sha256": "df7f828605f680f3ff52fe3468cbf8f5e20151fac0d5c31cd9a0de9765efecc1"
     },
     {
       "id": "schema:kfd-3:collaboration-interface",
       "sourcePath": "schemas/kfd-3/collaboration-interface.schema.json",
-      "sha256": "03e8d54c08f26bf8aff570995142684b04f0c97578c5fb58d29bc9f1559206d6"
+      "sha256": "e8d1f67914751b956c5a075eddbcc1ba482ddd21ce7298ab3a8b9df359a0ae44"
     },
     {
       "id": "schema:kfd-3:witness",
       "sourcePath": "schemas/kfd-3/witness.schema.json",
-      "sha256": "cb80768ab8a4f90f86d256555b1995ddb516371ccbe291a8c28581fa371ccd10"
+      "sha256": "95c25c7967e5d40a2aa2312e3cdfe984ce00e85db2457a370ce3d863cfa82c84"
     }
   ],
   "standardsMetadata": [
     {
       "id": "metadata:registry",
       "sourcePath": "registry.json",
-      "sha256": "b83cfadeb726e18f96ec4f7451c66091892f4964420dd81939d1120108991c38"
+      "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f"
     },
     {
       "id": "metadata:standards",
       "sourcePath": "standards.json",
-      "sha256": "394139c8915426e81eee7f7ea9f3d8209eb0e2b566ddadfccbddea2a3563585d"
+      "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc"
     },
     {
       "id": "metadata:release-impact",
       "sourcePath": "release-impact.json",
-      "sha256": "2a2257f3f8ff03fa3091d74b1b7b9571231b223167bd646ff289d9848584edbc"
+      "sha256": "ae55c7758d53f7e57593e0ddec72142babd9a8ff7c9003e98f8b468b953e0d7e"
     },
     {
       "id": "metadata:release-anchor",
       "sourcePath": "kfd.release.json",
-      "sha256": "d700e2011da213bb8ea7e2fa44c98163c52cd0843144b5744f4bf959c5b99c53"
+      "sha256": "fefebbaaac172609ce0a22b505d15556739c89971e7fdac2c9ef3c4ca4776a68"
     },
     {
       "id": "metadata:kfd-2-public-release-trust-claim",
       "sourcePath": ".buildchain/kfd-2/public-release-trust.claim.json",
-      "sha256": "48c729d5c492edbea3cfdb814254b2b55923800256bab8e652ecad1178caaba4"
+      "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c"
     }
   ],
   "packageExports": [
     {
       "id": "export:package-json",
       "sourcePath": "package.json#exports",
-      "sha256": "60dad27afe2d609287718e72d3a7c4bbca2d393db3c4d615233a6ab622aaa002"
+      "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6"
     },
     {
       "id": "export:npm-files",
       "sourcePath": "package.json#files",
-      "sha256": "60dad27afe2d609287718e72d3a7c4bbca2d393db3c4d615233a6ab622aaa002"
+      "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6"
     }
   ],
   "siteConsumptionContracts": [
     {
       "id": "site:kfd-site-bundle",
       "sourcePath": "site/kfd-site.json",
-      "sha256": "16526aba11d87762fea41a19dd7bccd7e02a03b842144fda494c14fd1f6c565d"
+      "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c"
     },
     {
       "id": "site:release-propagation",
@@ -357,79 +378,89 @@
     "minimalEntrypoints": [
       {
         "path": "README.md",
-        "sha256": "f158b84881e44f32758b3ff0cc165f478bc1ab6596ad16fe941caeb51573a536",
+        "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b",
         "description": "Start from the KFD worldview and current decision set."
       },
       {
         "path": "docs/MAP.md",
-        "sha256": "8d4d498a737aa7e3cf490653bcd1d13bc32dc057b3d322ff4a84b25f31aae47b",
+        "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d",
         "description": "Route readers and agents to the right KFD document or machine surface."
       },
+      {
+        "path": "TRADEMARKS.md",
+        "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1",
+        "description": "Understand what Apache-2.0 covers and what remains official, trademark-bound, or endorsement-bound."
+      },
       {
         "path": "registry.json",
-        "sha256": "b83cfadeb726e18f96ec4f7451c66091892f4964420dd81939d1120108991c38",
+        "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f",
         "description": "Consume the authoritative decision index."
       },
       {
         "path": "standards.json",
-        "sha256": "394139c8915426e81eee7f7ea9f3d8209eb0e2b566ddadfccbddea2a3563585d",
+        "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc",
         "description": "Discover KFD schema IDs, schema paths, concepts, and interface contracts."
       },
       {
         "path": "package.json#exports",
-        "sha256": "60dad27afe2d609287718e72d3a7c4bbca2d393db3c4d615233a6ab622aaa002",
+        "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6",
         "description": "Consume the shipped npm package surfaces."
       },
       {
         "path": "kfd.release.json",
-        "sha256": "d700e2011da213bb8ea7e2fa44c98163c52cd0843144b5744f4bf959c5b99c53",
+        "sha256": "fefebbaaac172609ce0a22b505d15556739c89971e7fdac2c9ef3c4ca4776a68",
         "description": "Inspect the explicit KFD package version anchor for the current Buildchain release line."
       },
       {
         "path": ".buildchain/kfd-2/public-release-trust.claim.json",
-        "sha256": "48c729d5c492edbea3cfdb814254b2b55923800256bab8e652ecad1178caaba4",
+        "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c",
         "description": "Inspect the explicit public KFD-2 claim passed into Buildchain release passport generation."
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "16526aba11d87762fea41a19dd7bccd7e02a03b842144fda494c14fd1f6c565d",
+        "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c",
         "description": "Render KFD-owned site text and decision pages without duplicating extraction logic."
       }
     ],
     "discoverability": [
       {
         "path": "README.md",
-        "sha256": "f158b84881e44f32758b3ff0cc165f478bc1ab6596ad16fe941caeb51573a536",
+        "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b",
         "description": "Human and agent entrypoint"
       },
+      {
+        "path": "TRADEMARKS.md",
+        "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1",
+        "description": "Official status, trademark, and authority boundary"
+      },
       {
         "path": "docs/MAP.md",
-        "sha256": "8d4d498a737aa7e3cf490653bcd1d13bc32dc057b3d322ff4a84b25f31aae47b",
+        "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d",
         "description": "Documentation routing entrypoint"
       },
       {
         "path": "registry.json",
-        "sha256": "b83cfadeb726e18f96ec4f7451c66091892f4964420dd81939d1120108991c38",
+        "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f",
         "description": "Machine-readable decision index"
       },
       {
         "path": "standards.json",
-        "sha256": "394139c8915426e81eee7f7ea9f3d8209eb0e2b566ddadfccbddea2a3563585d",
+        "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc",
         "description": "Machine-readable standards metadata"
       },
       {
         "path": ".buildchain/kfd-2/public-release-trust.claim.json",
-        "sha256": "48c729d5c492edbea3cfdb814254b2b55923800256bab8e652ecad1178caaba4",
+        "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c",
         "description": "KFD-2 public release trust claim"
       },
       {
         "path": "package.json",
-        "sha256": "60dad27afe2d609287718e72d3a7c4bbca2d393db3c4d615233a6ab622aaa002",
+        "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6",
         "description": "Package export map"
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "16526aba11d87762fea41a19dd7bccd7e02a03b842144fda494c14fd1f6c565d",
+        "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c",
         "description": "Site content projection"
       }
     ],
@@ -439,52 +470,61 @@
         "sha256": "188f752e89f3af4855e92b8c3dc379e41f1e326611ccaf8851977ee04c639606",
         "description": "Append-only decision and contribution constraints"
       },
+      {
+        "path": "TRADEMARKS.md",
+        "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1",
+        "description": "Trademark and official-status constraints"
+      },
       {
         "path": "scripts/check.mjs",
-        "sha256": "40bb6dfa9aef2cebe051f5183dce53aaae1ea6137b7c1abe6424baffac58db1c",
+        "sha256": "c541d7fd8318c225fd99e042f2c8adee4be8723505c28b79acd017c7eff23d46",
         "description": "Repository self-verification gate"
       },
       {
         "path": "site/kfd-site.json",
-        "sha256": "16526aba11d87762fea41a19dd7bccd7e02a03b842144fda494c14fd1f6c565d",
+        "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c",
         "description": "Site rendering boundary"
       }
     ],
     "choicePaths": [
       {
         "path": "README.md",
-        "sha256": "f158b84881e44f32758b3ff0cc165f478bc1ab6596ad16fe941caeb51573a536",
+        "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b",
         "description": "Human reading path"
       },
       {
         "path": "registry.json",
-        "sha256": "b83cfadeb726e18f96ec4f7451c66091892f4964420dd81939d1120108991c38",
+        "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f",
         "description": "Agent registry path"
       },
       {
         "path": "standards.json",
-        "sha256": "394139c8915426e81eee7f7ea9f3d8209eb0e2b566ddadfccbddea2a3563585d",
+        "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc",
         "description": "Agent standards metadata path"
       },
       {
         "path": ".buildchain/kfd-2/public-release-trust.claim.json",
-        "sha256": "48c729d5c492edbea3cfdb814254b2b55923800256bab8e652ecad1178caaba4",
+        "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c",
         "description": "Agent release trust claim path"
       },
       {
         "path": "package.json",
-        "sha256": "60dad27afe2d609287718e72d3a7c4bbca2d393db3c4d615233a6ab622aaa002",
+        "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6",
         "description": "Package consumption path"
       }
     ],
     "manuals": [
       {
         "path": "docs/MAP.md",
-        "sha256": "8d4d498a737aa7e3cf490653bcd1d13bc32dc057b3d322ff4a84b25f31aae47b"
+        "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d"
+      },
+      {
+        "path": "TRADEMARKS.md",
+        "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1"
       },
       {
         "path": "docs/kfd-3-collaboration-interface.md",
-        "sha256": "63263cf25cca617ec51595b3f46ac2af541794449cfd34b3042ff657dcd7838a"
+        "sha256": "d483ff6f8423a2e3f8e5dc547b62139d5c365678f9974d62063f8b523f14edb0"
       }
     ]
   },
@@ -493,6 +533,7 @@
     "reachableEntrypoints": [
       "readme",
       "docs-map",
+      "official-status-and-trademarks",
       "registry",
       "standards",
       "package-exports",
@@ -503,6 +544,7 @@
     "classifiedEntrypoints": [
       "readme",
       "docs-map",
+      "official-status-and-trademarks",
       "registry",
       "standards",
       "package-exports",
@@ -516,5 +558,17 @@
     "name": "kfd self-verification",
     "command": "node scripts/check.mjs"
   },
+  "residualRisk": [
+    {
+      "id": "human-language-interpretation",
+      "definedBy": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json#/$defs/residualRisk",
+      "riskType": "natural-language-semantic-risk",
+      "trustImpact": "downgrade-warning",
+      "machineProvability": "not-exhaustively-enumerable",
+      "agentAction": "semantic-review-required",
+      "reason": "Natural-language standard interpretation is inspectable and reviewable but not exhaustively enumerable from package bytes.",
+      "owner": "KFD maintainers"
+    }
+  ],
   "result": "pass"
 }

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

@@ -10,6 +10,28 @@
   "sourceRegistry": {
     "path": "registry.json"
   },
+  "factSources": [
+    {
+      "id": "public-kfd-fact-source",
+      "kind": "git-repository",
+      "host": "github",
+      "repository": "kungfu-systems/kfd",
+      "url": "https://github.com/kungfu-systems/kfd",
+      "loadBearingCoordinate": "commit-addressed repository contents",
+      "stableRenderedIndex": "https://kfd.libkungfu.dev",
+      "canonicalPaths": [
+        "decisions/kfd-N.md",
+        "registry.json",
+        "standards.json"
+      ],
+      "projectionSurfaces": [
+        "https://kfd.libkungfu.dev/N",
+        "npm:@kungfu-tech/kfd",
+        "Buildchain release passports"
+      ],
+      "extensionRequestNote": "GitHub issues are extension request paths; KFD facts are created only by committed repository contents."
+    }
+  ],
   "participants": [
     {
       "id": "human-reader",
@@ -55,6 +77,12 @@
       "participants": ["human-reader", "agent-reader", "maintainer"],
       "purpose": "Route readers and agents to the right KFD document or machine surface."
     },
+    {
+      "id": "official-status-and-trademarks",
+      "surface": "TRADEMARKS.md",
+      "participants": ["human-reader", "agent-reader", "package-consumer"],
+      "purpose": "Understand what Apache-2.0 covers and what remains official, trademark-bound, or endorsement-bound."
+    },
     {
       "id": "registry",
       "surface": "registry.json",
@@ -109,6 +137,14 @@
       "discoverability": { "fromMinimalEntrypoint": true, "path": "docs/MAP.md" },
       "maturity": "stable"
     },
+    {
+      "id": "official-status-and-trademarks",
+      "kind": "markdown-doc",
+      "participants": ["human-reader", "agent-reader", "package-consumer"],
+      "value": "Apache-2.0 reuse boundary, trademark boundary, official source boundary, fork/derivative guidance, and agent-facing authority rule.",
+      "discoverability": { "fromMinimalEntrypoint": true, "path": "TRADEMARKS.md" },
+      "maturity": "stable"
+    },
     {
       "id": "decision-texts",
       "kind": "markdown-doc",
@@ -153,7 +189,7 @@
       "id": "site-bundle-json",
       "kind": "json-api",
       "participants": ["site-consumer", "agent-reader"],
-      "value": "KFD-owned content projection consumed by the public site renderer.",
+      "value": "KFD-owned content projection consumed by the public site renderer, including decision metadata and the public KFD fact-source boundary.",
       "discoverability": { "fromMinimalEntrypoint": true, "path": "site/kfd-site.json" },
       "maturity": "stable"
     },
@@ -266,6 +302,19 @@
       "choice": "Change KFD through PR review, node scripts/check.mjs, and Buildchain release gates."
     }
   ],
+  "extensionRequests": [
+    {
+      "id": "kfd-2-trust-taxonomy-extension",
+      "participants": ["agent-reader", "maintainer", "release-system", "package-consumer"],
+      "trigger": "A human or agent needs a residual-risk, trust-impact, machine-provability, agent-action, or downgrade-reason value that is not present in schemas/kfd-2/trust-taxonomy.schema.json.",
+      "requestPath": {
+        "kind": "github-issue",
+        "target": "https://github.com/kungfu-systems/kfd/issues/new?title=KFD-2%20trust%20taxonomy%20extension%20request",
+        "template": "State the missing value, the taxonomy field, the product or release scenario, and why existing KFD-2 values cannot express the case."
+      },
+      "expectedOutcome": "KFD maintainers either add the value to the KFD-2 trust taxonomy schema or explain which existing value should be used."
+    }
+  ],
   "closure": {
     "classificationMode": "closed-world",
     "unclassifiedEntrypointsPolicy": "fail",