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

package/README.md

@@ -113,6 +113,23 @@ e.g. `https://kfd.libkungfu.dev/1`). This repository publishes
 `@kungfu-tech/kfd` — the decision texts plus a machine-readable
 `registry.json` — which the site consumes as its single fact source.
 
+Machine consumers that need KFD-owned standard identity should read
+`standards.json`. It is the versioned metadata surface for stable standard
+keys, document routes, schema IDs, and KFD-owned concept names. In Node or
+TypeScript projects, import it as:
+
+```js
+import standards from "@kungfu-tech/kfd/standards.json" with { type: "json" };
+```
+
+KFD-3 also publishes a general collaboration-interface schema and witness
+schema under `schemas/kfd-3/`. These schemas are for participant-facing product
+interfaces, not only agent APIs. A product such as Kungfu may implement an
+agent-first profile, but that profile remains a product-specific realization of
+KFD-3. The KFD-owned boundary is the standard vocabulary, schema IDs, and
+closed-world evidence shape. See
+[`docs/kfd-3-collaboration-interface.md`](docs/kfd-3-collaboration-interface.md).
+
 ## Current decisions
 
 | ID | Kind | Title | Status |
@@ -137,6 +154,9 @@ reference KFDs; KFDs never depend on repository internals.
 ```text
 decisions/     one markdown file per decision (kfd-N.md)
 registry.json  machine-readable index (schemaVersion 1, contract kfd-registry)
+standards.json machine-readable KFD standard metadata (schemaVersion 1,
+               contract kfd-standards-metadata)
+schemas/       JSON schemas for package metadata and KFD-owned schema IDs
 site/          machine-readable site bundle for kfd.libkungfu.dev renderers
 release-impact.json
                Buildchain surface-aware impact ledger for production release passports
@@ -144,11 +164,12 @@ scripts/       conformance check: registry and documents must agree
 ```
 
 `node scripts/check.mjs` (also `pnpm run check`) verifies numbering
-uniqueness, registry/document agreement, status validity, and the release
-impact ledger required by Buildchain production release passports. Releases are
-governed by Buildchain; this package versions itself under KFD-1's own rules:
-the outer package line remains `v1.0`, while patch and prerelease numbers are
-advanced by Buildchain release promotion.
+uniqueness, registry/document agreement, standards metadata/schema agreement,
+status validity, and the release impact ledger required by Buildchain
+production release passports. Releases are governed by Buildchain; this package
+versions itself under KFD-1's own rules: the outer package line remains `v1.0`,
+while patch and prerelease numbers are advanced by Buildchain release
+promotion.
 
 ## Release impact ledger
 

package/docs/MAP.md

@@ -8,7 +8,10 @@
 | What should a site renderer consume to render `kfd.libkungfu.dev`? | [`../site/kfd-site.json`](../site/kfd-site.json) |
 | What is the top-level product accountability principle? | [KFD-2](../decisions/kfd-2.md) |
 | What stance should products take toward humans and agents as reasoning participants? | [KFD-3](../decisions/kfd-3.md) |
+| What schema should products use for KFD-3 participant-facing collaboration interfaces? | [`kfd-3-collaboration-interface.md`](kfd-3-collaboration-interface.md) |
 | What does a specific decision say? | [`../decisions/`](../decisions) (index: [`../registry.json`](../registry.json)) |
+| What machine metadata should Buildchain or another consumer import for KFD standard identity and schema IDs? | [`../standards.json`](../standards.json) |
+| What schema validates the standards metadata surface? | [`../schemas/kfd-standards.schema.json`](../schemas/kfd-standards.schema.json) |
 | How do I cite a decision? | [`../README.md`](../README.md) — cite by number, e.g. `KFD-1` |
 | How do decisions change over time? | [`../CONTRIBUTING.md`](../CONTRIBUTING.md) — append-only; explicit supersession mints a new number |
 | How is this package versioned and released? | [KFD-1](../decisions/kfd-1.md) applied to itself; Buildchain governs releases |

package/docs/kfd-3-collaboration-interface.md

@@ -0,0 +1,59 @@
+# KFD-3 Collaboration Interface
+
+KFD-3 is a cooperation standard for intelligent participants. It is not an
+agent-only standard. Products can use it for humans, agents, operators,
+extension authors, API consumers, hosted-service users, service integrators,
+maintainers, and other participants who need to understand value, choices, and
+constraints before cooperating.
+
+The KFD-owned schema surface is intentionally general:
+
+- `schemas/kfd-3/collaboration-interface.schema.json` declares a product's
+  participant-facing collaboration interface.
+- `schemas/kfd-3/witness.schema.json` declares release or build evidence that
+  the interface is discoverable, classified, constraint-transparent, and closed
+  over reachable participant-facing entrypoints.
+
+KFD owns the standard identity, schema IDs, concept names, and compatibility
+rules. Product repositories own their concrete profiles. For example, Kungfu
+may expose an agent-first profile because agents are a first-class participant
+in the current product, but that profile remains a Kungfu implementation of
+KFD-3 rather than the definition of KFD-3 itself.
+
+## Required shape
+
+A product collaboration interface should identify:
+
+- participant profiles, such as `human`, `agent`, `operator`,
+  `extension-author`, or `api-consumer`;
+- minimal entrypoints that let each participant discover the rest of the
+  interface;
+- participant-visible surfaces, such as CLI commands, JSON APIs, manuals,
+  skills, GUI routes, envelopes, packages, or protocols;
+- visible constraints, including what is restricted, why, and where review or
+  escalation happens;
+- choice paths that let participants choose or decline safe cooperation modes;
+- a closure policy for reachable participant-facing entrypoints.
+
+The KFD-3 witness schema is intentionally stricter about closure: a passing
+closed-world proof reports reachable entrypoints, classified entrypoints, and
+an empty `unclassifiedEntrypoints` list. This prevents a product from exposing
+a participant-facing or callable backdoor API outside the declared interface.
+
+## Product profile boundary
+
+Concrete product profiles may add their own contracts, registry fields, command
+metadata, generated manuals, or audit output. Those fields should reference the
+KFD-3 schema IDs from `standards.json` instead of copying KFD-owned terms.
+
+Examples:
+
+- A Kungfu agent-first bridge can map local commands, provider skills, command
+  metadata, and operating manuals into a KFD-3 collaboration interface.
+- A Buildchain release passport can carry a KFD-3 witness once a downstream
+  product can freeze and verify the concrete interface artifact.
+- A hosted surface can use the same standard to show where policy constraints,
+  permission gates, and user choices are visible before cooperation is
+  requested.
+
+This keeps KFD-3 general while making real product interfaces testable.

package/package.json

@@ -1,15 +1,28 @@
 {
   "name": "@kungfu-tech/kfd",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "Kung Fu Decisions (KFD): the kungfu-systems organization-wide decision registry, as a consumable artifact",
   "license": "Apache-2.0",
   "files": [
     "README.md",
     "decisions",
     "registry.json",
+    "standards.json",
+    "schemas",
     "site",
     "docs"
   ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./README.md": "./README.md",
+    "./registry.json": "./registry.json",
+    "./standards.json": "./standards.json",
+    "./site/kfd-site.json": "./site/kfd-site.json",
+    "./schemas/*.json": "./schemas/*.json",
+    "./schemas/*/*.json": "./schemas/*/*.json",
+    "./decisions/*.md": "./decisions/*.md",
+    "./docs/*": "./docs/*"
+  },
   "scripts": {
     "check": "node scripts/check.mjs"
   },

package/schemas/kfd-1/contract-world.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kfd.libkungfu.dev/schemas/kfd-1/contract-world.schema.json",
+  "title": "KFD-1 contract world",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "contract",
+    "standard",
+    "factSource",
+    "surfaces"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "contract": {
+      "const": "kfd-1-contract-world"
+    },
+    "standard": {
+      "const": "kfd-1"
+    },
+    "factSource": {
+      "type": "string",
+      "minLength": 1
+    },
+    "surfaces": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "class",
+          "description"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+          },
+          "class": {
+            "enum": [
+              "integration-time",
+              "cross-time"
+            ]
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/kfd-1/witness.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kfd.libkungfu.dev/schemas/kfd-1/witness.schema.json",
+  "title": "KFD-1 witness",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "contract",
+    "standard",
+    "contractWorld",
+    "evidence"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "contract": {
+      "const": "kfd-1-witness"
+    },
+    "standard": {
+      "const": "kfd-1"
+    },
+    "contractWorld": {
+      "type": "object",
+      "required": [
+        "schemaId",
+        "digest"
+      ],
+      "properties": {
+        "schemaId": {
+          "const": "https://kfd.libkungfu.dev/schemas/kfd-1/contract-world.schema.json"
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "kind",
+          "path"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string",
+            "minLength": 1
+          },
+          "path": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/kfd-3/collaboration-interface.schema.json

@@ -0,0 +1,348 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kfd.libkungfu.dev/schemas/kfd-3/collaboration-interface.schema.json",
+  "title": "KFD-3 collaboration interface",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "contract",
+    "standard",
+    "product",
+    "sourceRegistry",
+    "participants",
+    "minimalEntrypoints",
+    "surfaces",
+    "transparentConstraints",
+    "choicePaths",
+    "closure"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "contract": {
+      "const": "kfd-3-collaboration-interface"
+    },
+    "standard": {
+      "const": "kfd-3"
+    },
+    "product": {
+      "type": "object",
+      "required": [
+        "name",
+        "version"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "repository": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "sourceRegistry": {
+      "$ref": "#/$defs/artifactPointer"
+    },
+    "participants": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/participant"
+      }
+    },
+    "minimalEntrypoints": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/entrypoint"
+      }
+    },
+    "surfaces": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/surface"
+      }
+    },
+    "transparentConstraints": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/transparentConstraint"
+      }
+    },
+    "choicePaths": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/choicePath"
+      }
+    },
+    "closure": {
+      "type": "object",
+      "required": [
+        "classificationMode",
+        "unclassifiedEntrypointsPolicy"
+      ],
+      "properties": {
+        "classificationMode": {
+          "enum": [
+            "closed-world",
+            "declared-open"
+          ]
+        },
+        "unclassifiedEntrypointsPolicy": {
+          "enum": [
+            "fail",
+            "warn",
+            "documented-open"
+          ]
+        },
+        "reachableSurfaceSource": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "artifactPointer": {
+      "type": "object",
+      "required": [
+        "path"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schemaId": {
+          "type": "string",
+          "format": "uri"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        }
+      },
+      "additionalProperties": true
+    },
+    "participant": {
+      "type": "object",
+      "required": [
+        "id",
+        "kind",
+        "description"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "kind": {
+          "enum": [
+            "human",
+            "agent",
+            "operator",
+            "extension-author",
+            "api-consumer",
+            "hosted-service-user",
+            "service-integrator",
+            "maintainer",
+            "other"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "entrypoint": {
+      "type": "object",
+      "required": [
+        "id",
+        "surface",
+        "participants"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "surface": {
+          "type": "string",
+          "minLength": 1
+        },
+        "participants": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "surface": {
+      "type": "object",
+      "required": [
+        "id",
+        "kind",
+        "participants",
+        "value",
+        "discoverability"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "kind": {
+          "enum": [
+            "cli-command",
+            "json-api",
+            "markdown-doc",
+            "skill",
+            "gui",
+            "web",
+            "config",
+            "envelope",
+            "package",
+            "protocol",
+            "other"
+          ]
+        },
+        "participants": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1
+        },
+        "discoverability": {
+          "type": "object",
+          "required": [
+            "fromMinimalEntrypoint"
+          ],
+          "properties": {
+            "fromMinimalEntrypoint": {
+              "type": "boolean"
+            },
+            "path": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": true
+        },
+        "maturity": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "transparentConstraint": {
+      "type": "object",
+      "required": [
+        "id",
+        "appliesTo",
+        "restriction",
+        "rationale",
+        "reviewPath"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "appliesTo": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "restriction": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rationale": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reviewPath": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "choicePath": {
+      "type": "object",
+      "required": [
+        "id",
+        "participants",
+        "choices"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "participants": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "choices": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "label"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/kfd-3/witness.schema.json

@@ -0,0 +1,153 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kfd.libkungfu.dev/schemas/kfd-3/witness.schema.json",
+  "title": "KFD-3 witness",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "contract",
+    "standard",
+    "collaborationInterface",
+    "sourceRegistry",
+    "evidence",
+    "closure"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "contract": {
+      "const": "kfd-3-witness"
+    },
+    "standard": {
+      "const": "kfd-3"
+    },
+    "collaborationInterface": {
+      "type": "object",
+      "required": [
+        "schemaId",
+        "digest"
+      ],
+      "properties": {
+        "schemaId": {
+          "const": "https://kfd.libkungfu.dev/schemas/kfd-3/collaboration-interface.schema.json"
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "sourceRegistry": {
+      "$ref": "#/$defs/artifactPointer"
+    },
+    "evidence": {
+      "type": "object",
+      "required": [
+        "minimalEntrypoints",
+        "discoverability",
+        "transparentConstraints",
+        "choicePaths"
+      ],
+      "properties": {
+        "minimalEntrypoints": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/artifactPointer"
+          }
+        },
+        "discoverability": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifactPointer"
+          }
+        },
+        "transparentConstraints": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifactPointer"
+          }
+        },
+        "choicePaths": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifactPointer"
+          }
+        },
+        "manuals": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifactPointer"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "closure": {
+      "type": "object",
+      "required": [
+        "classificationMode",
+        "reachableEntrypoints",
+        "classifiedEntrypoints",
+        "unclassifiedEntrypoints"
+      ],
+      "properties": {
+        "classificationMode": {
+          "const": "closed-world"
+        },
+        "reachableEntrypoints": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "classifiedEntrypoints": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "unclassifiedEntrypoints": {
+          "type": "array",
+          "maxItems": 0
+        }
+      },
+      "additionalProperties": true
+    },
+    "result": {
+      "enum": [
+        "pass",
+        "fail",
+        "warning"
+      ]
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "artifactPointer": {
+      "type": "object",
+      "required": [
+        "path"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/kfd-standards.schema.json

@@ -0,0 +1,200 @@
+{
+  "$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"
+            }
+          },
+          "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"
+          }
+        },
+        "concepts": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/standards.json

@@ -0,0 +1,128 @@
+{
+  "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": "Contracts 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"
+      },
+      "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"
+      },
+      "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"
+      },
+      "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"
+      },
+      "schemaPaths": {
+        "metadata": "schemas/kfd-standards.schema.json"
+      },
+      "concepts": {
+        "facts": "inspectable facts",
+        "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"
+      },
+      "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"
+      },
+      "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"
+      }
+    }
+  }
+}