{
  "schema": "libkungfu.kfx-site-manifest/v1",
  "status": "site-synthesis",
  "maturity": "alpha-source-projection",
  "headline": "Extend Kungfu without forking Core.",
  "proposition": "Build against a public extension contract, let Core admit exact content and capabilities, and project one semantic contribution across GUI, TUI, CLI, and Agent hosts.",
  "canonicalUrl": "https://kfx.libkungfu.dev/",
  "humanEntry": "https://kfx.libkungfu.dev/",
  "machineEntries": {
    "manifest": "https://kfx.libkungfu.dev/manifest.json",
    "llms": "https://kfx.libkungfu.dev/llms.txt",
    "architecture": "https://kfx.libkungfu.dev/architecture.json",
    "capabilityMap": "https://kfx.libkungfu.dev/capability-map.json"
  },
  "readerPaths": [
    {
      "id": "build",
      "label": "Build an extension",
      "summary": "Start from the installed, version-matched authoring kit; inspect, scaffold, validate, build, qualify, and package inert bytes before requesting native admission.",
      "href": "#capability-build",
      "sourceRefs": [
        "authoring-kit"
      ]
    },
    {
      "id": "understand",
      "label": "Understand the architecture",
      "summary": "Trace provider-owned semantics through package facets, Core control-plane decisions, admitted contributions, and host-native presentation.",
      "href": "#architecture",
      "sourceRefs": [
        "kfx-contract",
        "surface-parity-adr"
      ]
    },
    {
      "id": "audit",
      "label": "Audit trust and lifecycle",
      "summary": "Inspect immutable source, maturity, non-claims, admission inputs, capability grants, Warrants, and receipts before relying on a package.",
      "href": "#sources",
      "sourceRefs": [
        "lifecycle-adr",
        "trust-admission-adr"
      ]
    }
  ],
  "sources": [
    {
      "id": "kfx-contract",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "framework/kfx/kungfu-kfx.contract.json",
      "sha256": "4c17dddae597d19eb9ead4d3767669e3f8343a3b41cc9deb42c8eb5ff08a514d",
      "maturity": "alpha-source-contract",
      "role": "Package, Suite, facet, registry, admission, capability, lifecycle, receipt, and host contract"
    },
    {
      "id": "native-registry",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "framework/core/src/libkungfu/src/runtime/kfx/native_registry.cpp",
      "sha256": "98881b2110239f54706b05da88d8a847442b82782a32805aaa6d65faa9b21808",
      "maturity": "implemented-exact-source",
      "role": "Core-owned package discovery, semantic graph, lifecycle, and receipt implementation"
    },
    {
      "id": "authoring-kit",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "framework/core/src/python/kungfu/kfx_authoring_assets/contract.json",
      "sha256": "567ffd02c294aacd15e9ea8eb0e1d566c5703e9ec1c1fb81fa32bba781f7d346",
      "maturity": "installed-product-alpha",
      "role": "Version-matched offline authoring lifecycle, SDK projection, and webhook starter"
    },
    {
      "id": "lifecycle-adr",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "docs/adr/KF-ADR-019f86da-4f90-73f3-b027-c343b2bc8bcc.md",
      "sha256": "f175aa649773c0bc24b0eabdba24d7e973e3e050523f7467ca87b042b7cd23cc",
      "maturity": "accepted-implemented-upstream",
      "role": "Immutable package content and Core-owned transactional lifecycle authority"
    },
    {
      "id": "surface-parity-adr",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "docs/adr/KF-ADR-019f86da-4f90-72df-add3-948f3ae38c3a.md",
      "sha256": "f0c68bf2c2e80af8465f5247fb8cab9b2e636c8872c9ab7023b3986a758cca1e",
      "maturity": "accepted-implemented-upstream",
      "role": "One semantic contribution projected through GUI, TUI, CLI, and Agent hosts"
    },
    {
      "id": "trust-admission-adr",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "docs/adr/KF-ADR-019f86da-4f90-7d6c-926a-ddd27dbde8ab.md",
      "sha256": "cca8bdeee7d6e50f4507ada6e4122cfca2b35099c7ba3a9780d9785c55cce912",
      "maturity": "accepted-implemented-upstream",
      "role": "KFD facts and exact Buildchain attestations as non-authorizing admission evidence"
    },
    {
      "id": "profile-suite-adr",
      "owner": "kungfu-systems/kungfu",
      "repository": "https://github.com/kungfu-systems/kungfu",
      "ref": "c40f7a1a4149140558c655fa940d923bcc3c4154",
      "path": "docs/adr/KF-ADR-019f86da-4f90-7f46-b195-3af6228d17b1.md",
      "sha256": "cb4225f9e967d814585bd4b58ccba858147e8df124842d032240e75314431847",
      "maturity": "accepted-implemented-upstream",
      "role": "Agent-first Profile Suites carrying domain semantics over domain-neutral Core"
    }
  ],
  "sourceBoundary": "This page is a Site-owned reader synthesis of immutable Kungfu sources. Kungfu owns KFX schemas, commands, admission, capabilities, lifecycle, receipts, and qualification. The Site does not redefine or requalify them.",
  "adoptionBoundary": "This first surface uses exact Git sources and introduces no unpublished npm dependency. A later upstream-generated KFX Site Bundle may replace this projection after its own protected release and adoption gates.",
  "nonClaims": [
    "This Site projection is not a KFX specification, Release Passport, Warrant, capability grant, installation receipt, or qualification result.",
    "An authored or locally qualified package is not installed, activated, production-admitted, or safe for every workspace.",
    "KFD evidence and Buildchain attestations are admission inputs; neither creates ambient runtime authority.",
    "The exact upstream sources record their own qualification scope. This Site change does not rerun or widen that scope, promise stable APIs, or claim new platform support."
  ],
  "architecture": {
    "schema": "libkungfu.kfx-architecture/v1",
    "nodeCount": 20,
    "relationshipCount": 19,
    "sourceRefs": [
      "kfx-contract",
      "native-registry",
      "authoring-kit",
      "lifecycle-adr",
      "surface-parity-adr",
      "trust-admission-adr",
      "profile-suite-adr"
    ],
    "nonClaims": [
      "Presentation hosts do not own registry, admission, capability, lifecycle, or receipt authority.",
      "A contribution being discoverable, authored, qualified, installed, activated, or running are distinct states.",
      "Provider identity, first-party placement, Product roles, KFD fitness, or Buildchain provenance does not create ambient authority."
    ]
  },
  "capabilityMap": {
    "schema": "libkungfu.kfx-capability-map/v1",
    "categories": [
      "build",
      "connect",
      "add",
      "lifecycle",
      "trust",
      "surfaces"
    ],
    "itemCount": 19,
    "sourceRefs": [
      "kfx-contract",
      "native-registry",
      "authoring-kit",
      "lifecycle-adr",
      "surface-parity-adr",
      "trust-admission-adr",
      "profile-suite-adr"
    ],
    "nonClaims": [
      "Capability presence does not imply capability grant, activation, production admission, or universal safety.",
      "Maturity labels describe the exact cited source scope; they are not a new Site qualification verdict."
    ]
  }
}