@kungfu-tech/kfd 1.0.0-alpha.2 → 1.0.0-alpha.20

package/standards.json

@@ -17,14 +17,15 @@
       "id": "KFD-1",
       "number": 1,
       "label": "KFD-1",
-      "title": "Contracts must not drift: contract worlds need one fact source",
+      "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"
+        "path": "decisions/KFD-1.md",
+        "url": "https://kfd.libkungfu.dev/1",
+        "sha256": "0b7b1ec54d661b271f91f02cefa97b11e1d1ef9c637efd2d1878d5f9c9185d80"
       },
       "compatibility": {
         "packageLine": "v1.0",
@@ -42,11 +43,623 @@
         "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"
+        "witness": "contract witness",
+        "surfaceClass": "surface class",
+        "compatibilityImpact": "compatibility impact",
+        "impactProjection": "domain-specific impact projection"
+      },
+      "surfaceRegister": {
+        "factSource": "standards.json#/standards/kfd-1/surfaceRegister",
+        "surfaceClasses": [
+          "integration-time",
+          "cross-time"
+        ],
+        "compatibilityImpactClasses": [
+          "breaking",
+          "additive",
+          "none",
+          "unclassifiable"
+        ],
+        "surfaces": [
+          {
+            "id": "readme",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD package surface at README.md.",
+            "sourcePath": "README.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-1-document",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD decision text at decisions/KFD-1.md.",
+            "sourcePath": "decisions/KFD-1.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-document",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD decision text at decisions/KFD-2.md.",
+            "sourcePath": "decisions/KFD-2.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-3-document",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD decision text at decisions/KFD-3.md.",
+            "sourcePath": "decisions/KFD-3.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-4-document",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD decision text at decisions/KFD-4.md.",
+            "sourcePath": "decisions/KFD-4.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-registry",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published KFD package surface at registry.json.",
+            "sourcePath": "registry.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-standards",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published KFD package surface at standards.json.",
+            "sourcePath": "standards.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-standards-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-standards.schema.json.",
+            "sourcePath": "schemas/kfd-standards.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-1-contract-world-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-1/contract-world.schema.json.",
+            "sourcePath": "schemas/kfd-1/contract-world.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-1-witness-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-1/witness.schema.json.",
+            "sourcePath": "schemas/kfd-1/witness.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-trust-taxonomy-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-2/trust-taxonomy.schema.json.",
+            "sourcePath": "schemas/kfd-2/trust-taxonomy.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-release-claims-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-2/release-claims.schema.json.",
+            "sourcePath": "schemas/kfd-2/release-claims.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-release-trust-passport-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-2/release-trust-passport.schema.json.",
+            "sourcePath": "schemas/kfd-2/release-trust-passport.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-3-collaboration-interface-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-3/collaboration-interface.schema.json.",
+            "sourcePath": "schemas/kfd-3/collaboration-interface.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-3-witness-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-3/witness.schema.json.",
+            "sourcePath": "schemas/kfd-3/witness.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-4-observer-perspective-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-4/observer-perspective.schema.json.",
+            "sourcePath": "schemas/kfd-4/observer-perspective.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-site-bundle",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD package surface at site/kfd-site.json.",
+            "sourcePath": "site/kfd-site.json",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-doc-map",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published documentation surface at docs/MAP.md.",
+            "sourcePath": "docs/MAP.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "release-impact-ledger",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD package surface at release-impact.json.",
+            "sourcePath": "release-impact.json",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-check-gate",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Repository verification or projection script at scripts/check.mjs.",
+            "sourcePath": "scripts/check.mjs",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "release-propagation-graph",
+            "class": "integration-time",
+            "classes": [
+              "integration-time",
+              "cross-time"
+            ],
+            "description": "Published KFD package surface at buildchain.release-propagation.json.",
+            "sourcePath": "buildchain.release-propagation.json",
+            "weldRationale": "Consumers can integrate with this surface and later audit or replay it as a released fact.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "buildchain-build-workflow",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Release governance workflow surface at .github/workflows/build.yml.",
+            "sourcePath": ".github/workflows/build.yml",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "buildchain-ref-promotion-workflow",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Release governance workflow surface at .github/workflows/buildchain-ref-promotion.yml.",
+            "sourcePath": ".github/workflows/buildchain-ref-promotion.yml",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "release-propagation-workflow",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Release governance workflow surface at .github/workflows/release-propagation.yml.",
+            "sourcePath": ".github/workflows/release-propagation.yml",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "verify-workflow",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Release governance workflow surface at .github/workflows/verify.yml.",
+            "sourcePath": ".github/workflows/verify.yml",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-package-manifest",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published KFD package surface at package.json.",
+            "sourcePath": "package.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-release-anchor",
+            "class": "integration-time",
+            "classes": [
+              "integration-time",
+              "cross-time"
+            ],
+            "description": "Published KFD package surface at kfd.release.json.",
+            "sourcePath": "kfd.release.json",
+            "weldRationale": "Consumers can integrate with this surface and later audit or replay it as a released fact.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-public-release-trust-claim",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Buildchain release-passport evidence surface at .buildchain/kfd-2/public-release-trust.claim.json.",
+            "sourcePath": ".buildchain/kfd-2/public-release-trust.claim.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-trust-claims-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-2/trust-claims.schema.json.",
+            "sourcePath": "schemas/kfd-2/trust-claims.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-trust-assessment-schema",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Published JSON schema surface at schemas/kfd-2/trust-assessment.schema.json.",
+            "sourcePath": "schemas/kfd-2/trust-assessment.schema.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-foundation-trust-claims",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Buildchain evidence surface at .buildchain/kfd-2/kfd-foundation.trust-claims.json.",
+            "sourcePath": ".buildchain/kfd-2/kfd-foundation.trust-claims.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-foundation-trust-assessment",
+            "class": "integration-time",
+            "classes": [
+              "integration-time"
+            ],
+            "description": "Buildchain evidence surface at .buildchain/kfd-2/kfd-foundation.trust-assessment.json.",
+            "sourcePath": ".buildchain/kfd-2/kfd-foundation.trust-assessment.json",
+            "weldRationale": "Consumers can bind to this surface as an integration contract.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-1-usage-doc",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD usage documentation surface at docs/KFD-1-usage.md.",
+            "sourcePath": "docs/KFD-1-usage.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-2-usage-doc",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD usage documentation surface at docs/KFD-2-usage.md.",
+            "sourcePath": "docs/KFD-2-usage.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-3-usage-doc",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD usage documentation surface at docs/KFD-3-usage.md.",
+            "sourcePath": "docs/KFD-3-usage.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          },
+          {
+            "id": "kfd-4-usage-doc",
+            "class": "cross-time",
+            "classes": [
+              "cross-time"
+            ],
+            "description": "Published KFD usage documentation surface at docs/KFD-4-usage.md.",
+            "sourcePath": "docs/KFD-4-usage.md",
+            "weldRationale": "Consumers can audit, replay, or cite this surface after release.",
+            "impactProjection": {
+              "breaking": "Incompatible changes to this registered surface require an explicit compatibility action before the dependent gate may pass.",
+              "additive": "Backward-compatible additions to this registered surface must be declared and may proceed through the domain projection as additive impact.",
+              "none": "Changes that do not touch this registered surface do not create KFD-1 compatibility impact for this surface.",
+              "unclassifiable": "If impact cannot be classified, the surface register is deficient and must be fixed before the dependent gate may pass."
+            }
+          }
+        ]
       }
     },
     "kfd-2": {
@@ -60,8 +673,9 @@
       "revision": 1,
       "metadataSchemaVersion": "1",
       "document": {
-        "path": "decisions/kfd-2.md",
-        "url": "https://kfd.libkungfu.dev/2"
+        "path": "decisions/KFD-2.md",
+        "url": "https://kfd.libkungfu.dev/2",
+        "sha256": "6bc01776e478afc802c57c4e21a40bcfebf170f90ae039345d883c292053b622"
       },
       "compatibility": {
         "packageLine": "v1.0",
@@ -70,15 +684,79 @@
         "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"
+        "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",
+        "trustClaims": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-claims.schema.json",
+        "trustAssessment": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-assessment.schema.json"
       },
       "schemaPaths": {
-        "metadata": "schemas/kfd-standards.schema.json"
+        "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",
+        "trustClaims": "schemas/kfd-2/trust-claims.schema.json",
+        "trustAssessment": "schemas/kfd-2/trust-assessment.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."
+        },
+        "trustClaims": {
+          "contract": "kfd-2-trust-claims",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-claims.schema.json",
+          "schemaPath": "schemas/kfd-2/trust-claims.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic, required-field, verification-meaning, or responsibility-boundary changes require a new interface version or contract."
+        },
+        "trustAssessment": {
+          "contract": "kfd-2-trust-assessment",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-assessment.schema.json",
+          "schemaPath": "schemas/kfd-2/trust-assessment.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic, required-field, verification-meaning, or responsibility-boundary 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"
+        "trust": "trust from facts",
+        "trustClaim": "generic trust claim",
+        "trustClaims": "generic trust claims",
+        "trustAssessment": "generic trust assessment",
+        "claimSubject": "claim subject",
+        "claimSubjectKind": "claim subject kind",
+        "projection": "domain-specific trust projection"
       }
     },
     "kfd-3": {
@@ -86,14 +764,15 @@
       "id": "KFD-3",
       "number": 3,
       "label": "KFD-3",
-      "title": "Cooperation must start from transparent value: compliance must not be coerced",
+      "title": "Cooperation must start from trusted 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"
+        "path": "decisions/KFD-3.md",
+        "url": "https://kfd.libkungfu.dev/3",
+        "sha256": "049a7694f50e48774f3f1f74edccb46f0397a61211c027ab0eaa77e12d4e3f14"
       },
       "compatibility": {
         "packageLine": "v1.0",
@@ -102,16 +781,97 @@
         "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"
+        "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"
+        "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": {
+        "trustedValueClaim": "trusted value claim",
+        "valueEvidence": "value evidence",
+        "trustAssessmentLink": "trust assessment link",
+        "trustedValue": "trusted value",
         "transparentValue": "transparent value",
         "stableChoice": "stable choice",
         "explainableConstraints": "explainable constraints",
-        "nonCoercion": "non-coercive cooperation"
+        "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"
+      }
+    },
+    "kfd-4": {
+      "key": "kfd-4",
+      "id": "KFD-4",
+      "number": 4,
+      "label": "KFD-4",
+      "title": "Timelines must declare their observer: useful views need a stated perspective",
+      "kind": "procedure",
+      "status": "active",
+      "revision": 1,
+      "metadataSchemaVersion": "1",
+      "document": {
+        "path": "decisions/KFD-4.md",
+        "url": "https://kfd.libkungfu.dev/4",
+        "sha256": "7077a6446c8baa60d85426780cb7b2bee488133196b6f53d74f0eb151f6e26e4"
+      },
+      "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",
+        "observerPerspective": "https://kfd.libkungfu.dev/schemas/kfd-4/observer-perspective.schema.json"
+      },
+      "schemaPaths": {
+        "metadata": "schemas/kfd-standards.schema.json",
+        "observerPerspective": "schemas/kfd-4/observer-perspective.schema.json"
+      },
+      "interfaces": {
+        "observerPerspective": {
+          "contract": "kfd-4-observer-perspective",
+          "schemaVersion": 1,
+          "schemaId": "https://kfd.libkungfu.dev/schemas/kfd-4/observer-perspective.schema.json",
+          "schemaPath": "schemas/kfd-4/observer-perspective.schema.json",
+          "compatibilityRule": "Compatible additions may keep schemaVersion 1; semantic or required-field changes require a new interface version or contract."
+        }
+      },
+      "concepts": {
+        "observer": "observer",
+        "declaredPerspective": "declared perspective",
+        "observerPerspective": "observer perspective",
+        "acceptedFacts": "accepted facts",
+        "projectionPolicy": "projection policy",
+        "causalDominance": "causal dominance",
+        "degradedEvidence": "degraded evidence",
+        "timeline": "perspective-bearing timeline"
       }
     }
   }