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

package/schemas/kfd-standards.schema.json

@@ -0,0 +1,239 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kfd.libkungfu.dev/schemas/kfd-standards.schema.json",
+  "title": "KFD standards metadata",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "contract",
+    "metadataSchema",
+    "source",
+    "standards"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "contract": {
+      "const": "kfd-standards-metadata"
+    },
+    "metadataSchema": {
+      "type": "object",
+      "required": [
+        "id",
+        "path",
+        "version"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uri"
+        },
+        "path": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "source": {
+      "type": "object",
+      "required": [
+        "package",
+        "registry",
+        "decisionsDir"
+      ],
+      "properties": {
+        "package": {
+          "const": "@kungfu-tech/kfd"
+        },
+        "registry": {
+          "const": "registry.json"
+        },
+        "decisionsDir": {
+          "const": "decisions"
+        }
+      },
+      "additionalProperties": false
+    },
+    "standards": {
+      "type": "object",
+      "patternProperties": {
+        "^kfd-[1-9][0-9]*$": {
+          "$ref": "#/$defs/standard"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "standard": {
+      "type": "object",
+      "required": [
+        "key",
+        "id",
+        "number",
+        "label",
+        "title",
+        "kind",
+        "status",
+        "revision",
+        "metadataSchemaVersion",
+        "document",
+        "compatibility",
+        "schemaIds",
+        "schemaPaths",
+        "concepts"
+      ],
+      "properties": {
+        "key": {
+          "type": "string",
+          "pattern": "^kfd-[1-9][0-9]*$"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^KFD-[1-9][0-9]*$"
+        },
+        "number": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "label": {
+          "type": "string",
+          "pattern": "^KFD-[1-9][0-9]*$"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "enum": [
+            "principle",
+            "procedure"
+          ]
+        },
+        "status": {
+          "enum": [
+            "draft",
+            "active",
+            "superseded"
+          ]
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "metadataSchemaVersion": {
+          "type": "string"
+        },
+        "document": {
+          "type": "object",
+          "required": [
+            "path",
+            "url"
+          ],
+          "properties": {
+            "path": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri"
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            }
+          },
+          "additionalProperties": false
+        },
+        "compatibility": {
+          "type": "object",
+          "required": [
+            "packageLine",
+            "registrySchemaVersion",
+            "metadataSchemaVersion",
+            "rule"
+          ],
+          "properties": {
+            "packageLine": {
+              "type": "string"
+            },
+            "registrySchemaVersion": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "metadataSchemaVersion": {
+              "type": "string"
+            },
+            "rule": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "schemaIds": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "schemaPaths": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "interfaces": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "required": [
+              "contract",
+              "schemaVersion",
+              "schemaId",
+              "schemaPath"
+            ],
+            "properties": {
+              "contract": {
+                "type": "string",
+                "minLength": 1
+              },
+              "schemaVersion": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "schemaId": {
+                "type": "string",
+                "format": "uri"
+              },
+              "schemaPath": {
+                "type": "string",
+                "minLength": 1
+              },
+              "compatibilityRule": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "concepts": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/site/kfd-site.json

@@ -23,7 +23,7 @@
       "commitments": [
         {
           "id": "KFD-1",
-          "text": "contracts must not drift."
+          "text": "facts must not drift."
         },
         {
           "id": "KFD-2",
@@ -31,10 +31,10 @@
         },
         {
           "id": "KFD-3",
-          "text": "cooperation must start from transparent value, not coercion."
+          "text": "cooperation must start from transparent value."
         }
       ],
-      "summary": "Together they define the load-bearing path for Kungfu products: make contract worlds explicit, make important claims inspectable, and let humans and agents cooperate through visible value rather than hidden pressure."
+      "summary": "Together they define the load-bearing path for Kungfu products: make facts non-drifting, make trust inspectable from those facts, and let humans and agents cooperate through visible value rather than hidden pressure."
     },
     "foundationModel": {
       "heading": "Foundation model",
@@ -44,7 +44,7 @@
           "layer": "Fact-source ontology",
           "decision": "KFD-1",
           "readerQuestion": "What can count as a fact?",
-          "commitment": "A load-bearing fact must not drift: its contract world comes from one declared fact source."
+          "commitment": "Facts must not drift: a load-bearing contract world comes from one declared fact source."
         },
         {
           "layer": "Participant-to-object trust",
@@ -59,15 +59,15 @@
           "commitment": "Cooperation starts from transparent value, stable choice, and explainable constraints, not pressure."
         }
       ],
-      "chain": "stable facts -> trustworthy objects -> non-coercive cooperation",
+      "chain": "non-drifting facts -> inspectable trust -> transparent cooperation",
       "explanation": [
-        "This is why KFDs are not only internal governance text. KFD-1 is a procedure, but it gives the foundation model its first layer by making fact sources operational: a fact-bearing contract world must be declared, inspectable, and unable to drift invisibly. KFD-2 then defines how trust can stand on those facts. KFD-3 defines how humans and agents can cooperate once facts and trust are visible.",
+        "This is why KFDs are not only internal governance text. KFD-1 gives the foundation model its first layer by making fact sources operational: a fact-bearing contract world must be declared, inspectable, and unable to drift invisibly. KFD-2 then defines how trust can stand on those facts. KFD-3 defines how humans and agents can cooperate once facts and trust are visible.",
         "Real-world agent work turns ordinary work into a dense system of products, files, repositories, traces, policies, humans, and agents. In that world, complexity cannot be made safe by hidden state or forced compliance. It has to be compressed through non-drifting facts, inspectable trust, and voluntary cooperation. The goal is not to force increasingly capable participants into compliance through stronger pressure. It is to give humans and agents a shared worldview for adapting to a more complex world."
       ]
     },
     "productProofPath": {
       "heading": "Product proof path",
-      "body": "KFDs are not a detached manifesto, but they are not a demand that readers adopt a Kungfu product before understanding the decisions. A philosophy becomes load-bearing only when it can be seen in a concrete case. For that reference case, use the main Kungfu product entrypoint (`https://kungfu.tech`) for product philosophy, and Buildchain (`https://buildchain.libkungfu.dev`) for release and provenance accountability. This registry states the commitments; those entrypoints show how the commitments are meant to be borne in practice."
+      "body": "KFDs are not a detached manifesto, but they are not a demand that readers adopt a Kungfu product before understanding the decisions. A philosophy becomes load-bearing only when it can be seen in a concrete case. The first concrete case is this package itself: `standards.json`, `schemas/`, `docs/`, `site/kfd-site.json`, and `scripts/check.mjs` show how KFD-1, KFD-2, and KFD-3 are expressed as consumable interfaces for both humans and agents. For the broader product case, use the main Kungfu product entrypoint (`https://kungfu.tech`) for product philosophy, and Buildchain (`https://buildchain.libkungfu.dev`) for release and provenance accountability. This registry states the commitments; this package and those entrypoints show how the commitments are meant to be borne in practice."
     },
     "currentDecisions": {
       "heading": "Current decisions",
@@ -77,7 +77,34 @@
   "decisionPages": {
     "source": "registry.json",
     "bodySource": "registry.entries[].path",
-    "stableUrlField": "url"
+    "stableUrlField": "url",
+    "metadata": {
+      "licenseBoundary": {
+        "license": "Apache-2.0",
+        "licenseFile": "LICENSE",
+        "officialStatusAndTrademarks": "TRADEMARKS.md",
+        "summary": "Apache-2.0 covers repository contents; it does not grant KFD/Kungfu trademarks, official status, certification status, or endorsement."
+      },
+      "publicFactSource": {
+        "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."
+      }
+    }
   },
   "renderingBoundary": {
     "ownedByKfd": [
@@ -86,6 +113,8 @@
       "foundation model layers and chain",
       "product proof path text",
       "decision metadata",
+      "decision metadata fact source",
+      "license and official-status boundary",
       "decision markdown bodies"
     ],
     "ownedBySite": [

package/standards.json

@@ -0,0 +1,205 @@
+{
+  "schemaVersion": 1,
+  "contract": "kfd-standards-metadata",
+  "metadataSchema": {
+    "id": "https://kfd.libkungfu.dev/schemas/kfd-standards.schema.json",
+    "path": "schemas/kfd-standards.schema.json",
+    "version": "1"
+  },
+  "source": {
+    "package": "@kungfu-tech/kfd",
+    "registry": "registry.json",
+    "decisionsDir": "decisions"
+  },
+  "standards": {
+    "kfd-1": {
+      "key": "kfd-1",
+      "id": "KFD-1",
+      "number": 1,
+      "label": "KFD-1",
+      "title": "Facts must not drift: contract worlds need one fact source",
+      "kind": "procedure",
+      "status": "active",
+      "revision": 1,
+      "metadataSchemaVersion": "1",
+      "document": {
+        "path": "decisions/kfd-1.md",
+        "url": "https://kfd.libkungfu.dev/1",
+        "sha256": "32016c0962edcea9286db04ba24dab6c55400e9b26ce16a9d4b4ad647e17e7df"
+      },
+      "compatibility": {
+        "packageLine": "v1.0",
+        "registrySchemaVersion": 1,
+        "metadataSchemaVersion": "1",
+        "rule": "Substantive semantic changes mint a new KFD; compatible metadata additions keep schemaVersion 1."
+      },
+      "schemaIds": {
+        "metadata": "https://kfd.libkungfu.dev/schemas/kfd-standards.schema.json",
+        "contractWorld": "https://kfd.libkungfu.dev/schemas/kfd-1/contract-world.schema.json",
+        "witness": "https://kfd.libkungfu.dev/schemas/kfd-1/witness.schema.json"
+      },
+      "schemaPaths": {
+        "metadata": "schemas/kfd-standards.schema.json",
+        "contractWorld": "schemas/kfd-1/contract-world.schema.json",
+        "witness": "schemas/kfd-1/witness.schema.json"
+      },
+      "interfaces": {
+        "contractWorld": {
+          "contract": "kfd-1-contract-world",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-1/contract-world.schema.json",
+          "schemaPath": "schemas/kfd-1/contract-world.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        },
+        "witness": {
+          "contract": "kfd-1-witness",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-1/witness.schema.json",
+          "schemaPath": "schemas/kfd-1/witness.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        }
+      },
+      "concepts": {
+        "factSource": "fact source",
+        "contractWorld": "contract world",
+        "weldedSurfaceRegister": "welded-surface register",
+        "witness": "contract witness"
+      }
+    },
+    "kfd-2": {
+      "key": "kfd-2",
+      "id": "KFD-2",
+      "number": 2,
+      "label": "KFD-2",
+      "title": "Trust must start from facts: responsibility must be inspectable",
+      "kind": "principle",
+      "status": "active",
+      "revision": 1,
+      "metadataSchemaVersion": "1",
+      "document": {
+        "path": "decisions/kfd-2.md",
+        "url": "https://kfd.libkungfu.dev/2",
+        "sha256": "0c2da2113df6ef2829592f7ba67593059cb06e195ea527ee742501939efb3b9b"
+      },
+      "compatibility": {
+        "packageLine": "v1.0",
+        "registrySchemaVersion": 1,
+        "metadataSchemaVersion": "1",
+        "rule": "Substantive semantic changes mint a new KFD; compatible metadata additions keep schemaVersion 1."
+      },
+      "schemaIds": {
+        "metadata": "https://kfd.libkungfu.dev/schemas/kfd-standards.schema.json",
+        "trustTaxonomy": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json",
+        "releaseClaims": "https://kfd.libkungfu.dev/schemas/kfd-2/release-claims.schema.json",
+        "releaseTrustPassport": "https://kfd.libkungfu.dev/schemas/kfd-2/release-trust-passport.schema.json"
+      },
+      "schemaPaths": {
+        "metadata": "schemas/kfd-standards.schema.json",
+        "trustTaxonomy": "schemas/kfd-2/trust-taxonomy.schema.json",
+        "releaseClaims": "schemas/kfd-2/release-claims.schema.json",
+        "releaseTrustPassport": "schemas/kfd-2/release-trust-passport.schema.json"
+      },
+      "interfaces": {
+        "trustTaxonomy": {
+          "contract": "kfd-2-trust-taxonomy",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json",
+          "schemaPath": "schemas/kfd-2/trust-taxonomy.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; unknown taxonomy values fail validation until KFD records them in this schema."
+        },
+        "releaseClaims": {
+          "contract": "kfd-2-release-claims",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-2/release-claims.schema.json",
+          "schemaPath": "schemas/kfd-2/release-claims.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        },
+        "releaseTrustPassport": {
+          "contract": "kfd-2-release-trust-passport",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-2/release-trust-passport.schema.json",
+          "schemaPath": "schemas/kfd-2/release-trust-passport.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        }
+      },
+      "concepts": {
+        "facts": "inspectable facts",
+        "releaseClaim": "release claim",
+        "releaseClaims": "release claims",
+        "evidenceBinding": "evidence binding",
+        "auditBoundary": "audit boundary",
+        "residualRisk": "residual risk",
+        "riskType": "residual risk type",
+        "trustImpact": "trust impact",
+        "machineProvability": "machine provability",
+        "agentAction": "agent action",
+        "extensionRequest": "extension request",
+        "releaseTrustPassport": "release trust passport",
+        "responsibilityState": "responsibility state",
+        "trust": "trust from facts"
+      }
+    },
+    "kfd-3": {
+      "key": "kfd-3",
+      "id": "KFD-3",
+      "number": 3,
+      "label": "KFD-3",
+      "title": "Cooperation must start from transparent value: compliance must not be coerced",
+      "kind": "principle",
+      "status": "active",
+      "revision": 1,
+      "metadataSchemaVersion": "1",
+      "document": {
+        "path": "decisions/kfd-3.md",
+        "url": "https://kfd.libkungfu.dev/3",
+        "sha256": "f37320562b6d82630358663acc239a3ee84bdc930b287c6cb0b2fb0295110672"
+      },
+      "compatibility": {
+        "packageLine": "v1.0",
+        "registrySchemaVersion": 1,
+        "metadataSchemaVersion": "1",
+        "rule": "Substantive semantic changes mint a new KFD; compatible metadata additions keep schemaVersion 1."
+      },
+      "schemaIds": {
+        "metadata": "https://kfd.libkungfu.dev/schemas/kfd-standards.schema.json",
+        "collaborationInterface": "https://kfd.libkungfu.dev/schemas/kfd-3/collaboration-interface.schema.json",
+        "witness": "https://kfd.libkungfu.dev/schemas/kfd-3/witness.schema.json"
+      },
+      "schemaPaths": {
+        "metadata": "schemas/kfd-standards.schema.json",
+        "collaborationInterface": "schemas/kfd-3/collaboration-interface.schema.json",
+        "witness": "schemas/kfd-3/witness.schema.json"
+      },
+      "interfaces": {
+        "collaborationInterface": {
+          "contract": "kfd-3-collaboration-interface",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-3/collaboration-interface.schema.json",
+          "schemaPath": "schemas/kfd-3/collaboration-interface.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        },
+        "witness": {
+          "contract": "kfd-3-witness",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-3/witness.schema.json",
+          "schemaPath": "schemas/kfd-3/witness.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        }
+      },
+      "concepts": {
+        "transparentValue": "transparent value",
+        "stableChoice": "stable choice",
+        "explainableConstraints": "explainable constraints",
+        "nonCoercion": "non-coercive cooperation",
+        "participant": "participant",
+        "collaborationInterface": "collaboration interface",
+        "minimalEntrypoint": "minimal entrypoint",
+        "discoverability": "discoverability",
+        "closure": "closed-world interface classification",
+        "choicePath": "choice path",
+        "extensionRequest": "extension request",
+        "extensionPath": "extension path"
+      }
+    }
+  }
+}