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

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

@@ -0,0 +1,574 @@
+{
+  "schemaVersion": 1,
+  "contract": "kfd-3-witness",
+  "id": "kfd-repository",
+  "standard": "kfd-3",
+  "collaborationInterface": {
+    "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-3/collaboration-interface.schema.json",
+    "digest": "sha256:e32f2196399d37db202ccc656386bddc346871243c3db6782d26b5a88f831595"
+  },
+  "sourceRegistry": {
+    "id": "kfd-collaboration-interface",
+    "path": ".buildchain/kfd-3/collaboration-interface.json",
+    "sha256": "e32f2196399d37db202ccc656386bddc346871243c3db6782d26b5a88f831595"
+  },
+  "artifact": {
+    "name": "@kungfu-tech/kfd",
+    "path": "npm:@kungfu-tech/kfd",
+    "digest": "sha256:e32f2196399d37db202ccc656386bddc346871243c3db6782d26b5a88f831595"
+  },
+  "surfaces": [
+    {
+      "id": "readme",
+      "name": "readme",
+      "kind": "markdown-doc",
+      "participantProfile": "human-reader,agent-reader",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "README.md"
+    },
+    {
+      "id": "docs-map",
+      "name": "docs-map",
+      "kind": "markdown-doc",
+      "participantProfile": "human-reader,agent-reader,maintainer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "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",
+      "kind": "markdown-doc",
+      "participantProfile": "human-reader,agent-reader,maintainer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "decisions/*.md"
+    },
+    {
+      "id": "registry-json",
+      "name": "registry-json",
+      "kind": "json-api",
+      "participantProfile": "agent-reader,package-consumer,site-consumer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "registry.json"
+    },
+    {
+      "id": "standards-json",
+      "name": "standards-json",
+      "kind": "json-api",
+      "participantProfile": "agent-reader,package-consumer,release-system",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "standards.json"
+    },
+    {
+      "id": "schemas",
+      "name": "schemas",
+      "kind": "json-api",
+      "participantProfile": "agent-reader,package-consumer,release-system",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "schemas/**/*.json"
+    },
+    {
+      "id": "package-exports",
+      "name": "package-exports",
+      "kind": "package",
+      "participantProfile": "package-consumer,agent-reader",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "package.json#exports"
+    },
+    {
+      "id": "site-bundle-json",
+      "name": "site-bundle-json",
+      "kind": "json-api",
+      "participantProfile": "site-consumer,agent-reader",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "site/kfd-site.json"
+    },
+    {
+      "id": "release-impact-json",
+      "name": "release-impact-json",
+      "kind": "json-api",
+      "participantProfile": "release-system,maintainer,agent-reader",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "release-impact.json"
+    },
+    {
+      "id": "release-anchor-json",
+      "name": "release-anchor-json",
+      "kind": "json-api",
+      "participantProfile": "release-system,agent-reader,maintainer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "kfd.release.json"
+    },
+    {
+      "id": "release-propagation-json",
+      "name": "release-propagation-json",
+      "kind": "json-api",
+      "participantProfile": "release-system,site-consumer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "buildchain.release-propagation.json"
+    },
+    {
+      "id": "kfd-1-witness",
+      "name": "kfd-1-witness",
+      "kind": "json-api",
+      "participantProfile": "release-system,maintainer,agent-reader",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": ".buildchain/kfd-1/contract-world.witness.json"
+    },
+    {
+      "id": "kfd-2-public-release-trust-claim",
+      "name": "kfd-2-public-release-trust-claim",
+      "kind": "json-api",
+      "participantProfile": "release-system,maintainer,agent-reader,package-consumer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": ".buildchain/kfd-2/public-release-trust.claim.json"
+    },
+    {
+      "id": "kfd-3-self-witnesses",
+      "name": "kfd-3-self-witnesses",
+      "kind": "json-api",
+      "participantProfile": "release-system,maintainer,agent-reader",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": ".buildchain/kfd-3/*.json"
+    },
+    {
+      "id": "release-workflows",
+      "name": "release-workflows",
+      "kind": "config",
+      "participantProfile": "release-system,maintainer",
+      "availability": "stable",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": ".github/workflows/*.yml"
+    },
+    {
+      "id": "registry",
+      "name": "registry",
+      "kind": "entrypoint",
+      "participantProfile": "agent-reader,package-consumer,site-consumer",
+      "availability": "shipped",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "registry.json"
+    },
+    {
+      "id": "standards",
+      "name": "standards",
+      "kind": "entrypoint",
+      "participantProfile": "agent-reader,package-consumer,release-system",
+      "availability": "shipped",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "standards.json"
+    },
+    {
+      "id": "release-anchor",
+      "name": "release-anchor",
+      "kind": "entrypoint",
+      "participantProfile": "release-system,agent-reader",
+      "availability": "shipped",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "kfd.release.json"
+    },
+    {
+      "id": "site-bundle",
+      "name": "site-bundle",
+      "kind": "entrypoint",
+      "participantProfile": "site-consumer,agent-reader",
+      "availability": "shipped",
+      "visibility": "public",
+      "participantFacing": true,
+      "public": true,
+      "sourcePath": "site/kfd-site.json"
+    }
+  ],
+  "docs": [
+    {
+      "id": "doc:readme",
+      "sourcePath": "README.md",
+      "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b"
+    },
+    {
+      "id": "doc:trademarks",
+      "sourcePath": "TRADEMARKS.md",
+      "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1"
+    },
+    {
+      "id": "doc:docs-map",
+      "sourcePath": "docs/MAP.md",
+      "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d"
+    },
+    {
+      "id": "doc:kfd-2-release-trust",
+      "sourcePath": "docs/kfd-2-release-trust.md",
+      "sha256": "9ba323334750cf285f08de21286f58c04b872189febf38a4e8fd50c0791020b3"
+    },
+    {
+      "id": "doc:kfd-3-collaboration-interface",
+      "sourcePath": "docs/kfd-3-collaboration-interface.md",
+      "sha256": "d483ff6f8423a2e3f8e5dc547b62139d5c365678f9974d62063f8b523f14edb0"
+    },
+    {
+      "id": "decision:kfd-1",
+      "sourcePath": "decisions/kfd-1.md",
+      "sha256": "32016c0962edcea9286db04ba24dab6c55400e9b26ce16a9d4b4ad647e17e7df"
+    },
+    {
+      "id": "decision:kfd-2",
+      "sourcePath": "decisions/kfd-2.md",
+      "sha256": "0c2da2113df6ef2829592f7ba67593059cb06e195ea527ee742501939efb3b9b"
+    },
+    {
+      "id": "decision:kfd-3",
+      "sourcePath": "decisions/kfd-3.md",
+      "sha256": "f37320562b6d82630358663acc239a3ee84bdc930b287c6cb0b2fb0295110672"
+    }
+  ],
+  "schemas": [
+    {
+      "id": "schema:kfd-standards",
+      "sourcePath": "schemas/kfd-standards.schema.json",
+      "sha256": "2ecc7049d13463700f143f4e8c40488d6587484c94d26e827c239eeedc892336"
+    },
+    {
+      "id": "schema:kfd-1:contract-world",
+      "sourcePath": "schemas/kfd-1/contract-world.schema.json",
+      "sha256": "6be00cca75c80bf96429eb62336989d8931ea380d86388fcb8b834dcf8d3c13b"
+    },
+    {
+      "id": "schema:kfd-1:witness",
+      "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": "0f52c4a9949f62163a0fbe14fefc2f2f93f548ae18b6b5c07eb87aedca4c0be0"
+    },
+    {
+      "id": "schema:kfd-2:release-trust-passport",
+      "sourcePath": "schemas/kfd-2/release-trust-passport.schema.json",
+      "sha256": "df7f828605f680f3ff52fe3468cbf8f5e20151fac0d5c31cd9a0de9765efecc1"
+    },
+    {
+      "id": "schema:kfd-3:collaboration-interface",
+      "sourcePath": "schemas/kfd-3/collaboration-interface.schema.json",
+      "sha256": "e8d1f67914751b956c5a075eddbcc1ba482ddd21ce7298ab3a8b9df359a0ae44"
+    },
+    {
+      "id": "schema:kfd-3:witness",
+      "sourcePath": "schemas/kfd-3/witness.schema.json",
+      "sha256": "95c25c7967e5d40a2aa2312e3cdfe984ce00e85db2457a370ce3d863cfa82c84"
+    }
+  ],
+  "standardsMetadata": [
+    {
+      "id": "metadata:registry",
+      "sourcePath": "registry.json",
+      "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f"
+    },
+    {
+      "id": "metadata:standards",
+      "sourcePath": "standards.json",
+      "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc"
+    },
+    {
+      "id": "metadata:release-impact",
+      "sourcePath": "release-impact.json",
+      "sha256": "ae55c7758d53f7e57593e0ddec72142babd9a8ff7c9003e98f8b468b953e0d7e"
+    },
+    {
+      "id": "metadata:release-anchor",
+      "sourcePath": "kfd.release.json",
+      "sha256": "fefebbaaac172609ce0a22b505d15556739c89971e7fdac2c9ef3c4ca4776a68"
+    },
+    {
+      "id": "metadata:kfd-2-public-release-trust-claim",
+      "sourcePath": ".buildchain/kfd-2/public-release-trust.claim.json",
+      "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c"
+    }
+  ],
+  "packageExports": [
+    {
+      "id": "export:package-json",
+      "sourcePath": "package.json#exports",
+      "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6"
+    },
+    {
+      "id": "export:npm-files",
+      "sourcePath": "package.json#files",
+      "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6"
+    }
+  ],
+  "siteConsumptionContracts": [
+    {
+      "id": "site:kfd-site-bundle",
+      "sourcePath": "site/kfd-site.json",
+      "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c"
+    },
+    {
+      "id": "site:release-propagation",
+      "sourcePath": "buildchain.release-propagation.json",
+      "sha256": "71f9b54b9e76111178635804615fb0b4600f3131a7871b7c7817395b708c6fb3"
+    }
+  ],
+  "evidence": {
+    "minimalEntrypoints": [
+      {
+        "path": "README.md",
+        "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b",
+        "description": "Start from the KFD worldview and current decision set."
+      },
+      {
+        "path": "docs/MAP.md",
+        "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": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f",
+        "description": "Consume the authoritative decision index."
+      },
+      {
+        "path": "standards.json",
+        "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc",
+        "description": "Discover KFD schema IDs, schema paths, concepts, and interface contracts."
+      },
+      {
+        "path": "package.json#exports",
+        "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6",
+        "description": "Consume the shipped npm package surfaces."
+      },
+      {
+        "path": "kfd.release.json",
+        "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": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c",
+        "description": "Inspect the explicit public KFD-2 claim passed into Buildchain release passport generation."
+      },
+      {
+        "path": "site/kfd-site.json",
+        "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c",
+        "description": "Render KFD-owned site text and decision pages without duplicating extraction logic."
+      }
+    ],
+    "discoverability": [
+      {
+        "path": "README.md",
+        "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b",
+        "description": "Human and agent entrypoint"
+      },
+      {
+        "path": "TRADEMARKS.md",
+        "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1",
+        "description": "Official status, trademark, and authority boundary"
+      },
+      {
+        "path": "docs/MAP.md",
+        "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d",
+        "description": "Documentation routing entrypoint"
+      },
+      {
+        "path": "registry.json",
+        "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f",
+        "description": "Machine-readable decision index"
+      },
+      {
+        "path": "standards.json",
+        "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc",
+        "description": "Machine-readable standards metadata"
+      },
+      {
+        "path": ".buildchain/kfd-2/public-release-trust.claim.json",
+        "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c",
+        "description": "KFD-2 public release trust claim"
+      },
+      {
+        "path": "package.json",
+        "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6",
+        "description": "Package export map"
+      },
+      {
+        "path": "site/kfd-site.json",
+        "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c",
+        "description": "Site content projection"
+      }
+    ],
+    "transparentConstraints": [
+      {
+        "path": "CONTRIBUTING.md",
+        "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": "c541d7fd8318c225fd99e042f2c8adee4be8723505c28b79acd017c7eff23d46",
+        "description": "Repository self-verification gate"
+      },
+      {
+        "path": "site/kfd-site.json",
+        "sha256": "cb837c81d6fe02700528c5111558597225414c0c4fd9ab7279c94c61a3b4390c",
+        "description": "Site rendering boundary"
+      }
+    ],
+    "choicePaths": [
+      {
+        "path": "README.md",
+        "sha256": "25d733aa98a62dad100df10b9a3393364442f0cd06c2daab08e4a99471dd447b",
+        "description": "Human reading path"
+      },
+      {
+        "path": "registry.json",
+        "sha256": "f58ec6929da6a5daada78265b937b9d0aebec7cbfb42325b279bb6ae77df830f",
+        "description": "Agent registry path"
+      },
+      {
+        "path": "standards.json",
+        "sha256": "7ac1410e182f5e66e5723c46f914ab652b2b4fad5b8fe5411172230c9ef146fc",
+        "description": "Agent standards metadata path"
+      },
+      {
+        "path": ".buildchain/kfd-2/public-release-trust.claim.json",
+        "sha256": "71986f6fd5d73a1fd74c1b6b68bcf6fe16bf67c2cea9cb3595bdbeebee10182c",
+        "description": "Agent release trust claim path"
+      },
+      {
+        "path": "package.json",
+        "sha256": "c082af3754b3b382219e8fb1973a228f0f38ab8846178ade639488be2626cdb6",
+        "description": "Package consumption path"
+      }
+    ],
+    "manuals": [
+      {
+        "path": "docs/MAP.md",
+        "sha256": "c53b0d7bdc83c7e7c335e4aa23f54a76c9874908ea4d9e5d7861be3b0875bd8d"
+      },
+      {
+        "path": "TRADEMARKS.md",
+        "sha256": "c59e3e936c2a0f2e3598fc7f8977c734dfc1c23df506c8c8360eb39e8e2ee3e1"
+      },
+      {
+        "path": "docs/kfd-3-collaboration-interface.md",
+        "sha256": "d483ff6f8423a2e3f8e5dc547b62139d5c365678f9974d62063f8b523f14edb0"
+      }
+    ]
+  },
+  "closure": {
+    "classificationMode": "closed-world",
+    "reachableEntrypoints": [
+      "readme",
+      "docs-map",
+      "official-status-and-trademarks",
+      "registry",
+      "standards",
+      "package-exports",
+      "release-anchor",
+      "kfd-2-public-release-trust-claim",
+      "site-bundle"
+    ],
+    "classifiedEntrypoints": [
+      "readme",
+      "docs-map",
+      "official-status-and-trademarks",
+      "registry",
+      "standards",
+      "package-exports",
+      "release-anchor",
+      "kfd-2-public-release-trust-claim",
+      "site-bundle"
+    ],
+    "unclassifiedEntrypoints": []
+  },
+  "verifier": {
+    "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"
+}