# kfd.libkungfu.dev Kung Fu Decisions (KFD) is the kungfu-systems decision registry surface. Reader contract: libkungfu-dev-reader-contract/v1 Audience: Protocol builders Question: How can independent systems cooperate without sharing a control plane? Promise: Start with KFD's continuity question and adoption boundary, then descend into the numbered authority, schemas, and exact decision text. Human entry: - https://kfd.libkungfu.dev/ - https://kfd.libkungfu.dev/concepts/ - https://kfd.libkungfu.dev/agent-hub/ Conceptual compression: - Question: What must remain continuous when the agent, session, repository, authority, or execution path changes—but the work continues? - False equivalences: running != authorized; retry != same attempt; same output != same result; success != admitted Fact - Reader guide: https://kfd.libkungfu.dev/concepts/ - Relationship: non-normative-reader-compression-of-numbered-decisions - Normative: false - Authority boundary: Numbered decisions remain authoritative; terminology.json owns the canonical names and anti-misreading boundaries projected by this page. Installed Kungfu Agent Hub qualification: - Run: kungfu agent hub qualify --output-dir - Verify: kungfu agent hub verify --qualification-dir - Ownership: KFD owns the fixed suite and offline report verifier; Kungfu owns its product semantics, isolated execution, installed-artifact binding, and human or agent explanation. - Claim boundary: Behavior, evidence, and authority are independent dimensions. A generated starter intentionally produces 0/20 behavior while its report and adapter binding verify as valid evidence; neither that result nor a 20/20 demo grants qualification or certification. Only kfd test agent-hub executes Hub 20 against the named adapter artifact. Kungfu may project that report into an exact installed-product qualification, but it does not turn the result into KFD certification, a security assessment, production fitness, remote-network interoperability, or external adoption. KFD-11 through KFD-13 activation interfaces: - Status: draft-interfaces - Relationship: draft-qualification-and-activation-interfaces - Normative: false - Authority: The numbered KFD-11 through KFD-13 decisions remain authoritative and remain draft until a later explicit activation decision. - Discovery: https://kfd.libkungfu.dev/activation-contracts.json - kfd-11-adopter-witness: https://kfd.libkungfu.dev/schemas/kfd-11/adopter-witness.schema.json - kfd-12-adopter-witness: https://kfd.libkungfu.dev/schemas/kfd-12/adopter-witness.schema.json - kfd-13-adopter-witness: https://kfd.libkungfu.dev/schemas/kfd-13/adopter-witness.schema.json - kfd-11-13-qualification-report: https://kfd.libkungfu.dev/schemas/kfd-activation/qualification-report.schema.json - kfd-11-13-activation-record: https://kfd.libkungfu.dev/schemas/kfd-activation/activation-record.schema.json - Non-claims: Schema validity is structural conformance only. A founding implementation or self-review is not activation evidence. This manifest does not activate KFD-11, KFD-12, or KFD-13. Independent implementation and verification: - Promise: Implement KFD without Kungfu — scaffold an adapter in Python, Rust, Node.js, or C++, then verify it offline. - Reader model: site.libkungfu.dev/kfd-independent-reader-model/v1 - Understanding path: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd demo agent-hub --output agent-hub-demo-report.json - Understanding outcome: [object Object] - Understanding boundary: The packaged reference adapter demonstrates the contract. It is non-product code and is not adopter evidence or certification. - Failure lesson: A successful call is not evidence that the Pursuit completed. Expected rejected / completion-unproved / rejected. - Adopter path: - Scaffold: Generate a deterministic fail-closed starter. No Hub semantics are implemented yet. Expected: exit 0 · new directory created. Command: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd scaffold agent-hub --language python --output my-agent-hub-adapter - Run starter smoke: Check only the jsonl-stdio/v1 request and response envelope. Expected: exit 0 · envelope pass. Command: python3 my-agent-hub-adapter/smoke.py - Understand the Hub model: Read what the eight semantic categories protect before writing product decisions. - Implement Hub semantics: Replace evaluate() with product-owned behavior for the fixed scenarios. KFD cannot supply your product decisions. Target before claiming conformance: 20/20. - Test Hub 20: Run the fixed suite against your adapter bytes. The unmodified starter deliberately returns scenario-not-implemented. Untouched starter: exit 1 · 0/20 · report.valid=false. Command: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd test agent-hub --adapter ./my-agent-hub-adapter/adapter.py --output agent-hub-report.json - Verify report offline: Recompute the retained report and root closure, optionally including adapter bytes. This does not rerun the adapter or certify production fitness. Expected: exit 0 · verification.valid=true · adapter bytes checked. Command: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd verify agent-hub-report agent-hub-report.json --adapter ./my-agent-hub-adapter/adapter.py - Hub semantics: Negotiation (3): Both Hubs agree on the exact profile, required features, and semantic root before exchange. Delivery (5): Delivery stays separate from admission, while duplicates, idempotency conflicts, and delays remain explicit. Authority (3): Delegation can narrow but cannot silently amplify or outlive a revoked Warrant. Conflict (2): Concurrent disagreement stays visible instead of disappearing behind last-write-wins. Knowledge (3): Partial, intentionally withheld, and unavailable knowledge remain different states. Completion (1): A successful call cannot be promoted into proof that the Pursuit completed. Recovery (1): Offline divergence is surfaced when Hubs reconnect instead of being overwritten. Portability (2): Export and import preserve semantic roots and reject meaning-changing drift. - Outcome: A bounded, artifact-linked answer to whether two independently owned Hubs preserve meaning when Work crosses their boundary. - Native install: brew install kungfu-systems/tap/kfd - Native version: kfd --version - Native capabilities: verify, bundle - Native capability boundary: Each KFD GitHub Release now carries Rust-native archives for Linux x86_64 and arm64, macOS x86_64 and arm64, and Windows x86_64. The executable name is permanently `kfd` (`kfd.exe` on Windows), and `kfd --version` matches the exact KFD Release version. The native CLI provides `verify` and `bundle`; use the npm workflow above when you need `scaffold` or `test` orchestration. Every target includes a SHA-256 file and source-bound provenance. See [Native CLI downloads and capability boundaries](docs/native-cli.md). - Languages: Python, Rust, Node.js, C++ - Scaffold: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd scaffold agent-hub --language python --output my-agent-hub-adapter - Run envelope smoke: python3 my-agent-hub-adapter/smoke.py - Test Hub 20: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd test agent-hub --adapter ./my-agent-hub-adapter/adapter.py --output agent-hub-report.json - Verify report evidence: npx --yes --package @kungfu-tech/kfd@1.0.0-alpha.67 kfd verify agent-hub-report agent-hub-report.json --adapter ./my-agent-hub-adapter/adapter.py - Starter boundary: The scaffold is a deterministic, fail-closed starter. Before implementation, smoke exits `0`, Hub 20 exits `1` at `0/20`, and offline evidence verification exits `0` with `valid`; qualification and certification stay `false`. Implementers then replace `evaluate()` with product decisions across negotiation, delivery, authority, conflict, knowledge, completion, recovery, and portability until Hub 20 reaches `20/20`. - Offline boundary: Package acquisition is separate from offline verification. Network or a local package cache may be needed to obtain the immutable package bytes; after the package, report, and optional adapter bytes are present, the report verifier performs no network access. - Claim boundary: These results do not certify an implementation or prove security, production fitness, complete semantic coverage, KFD-10 activation, or adoption by an independent organization. [Verify an Agent Hub report](/agent-hub/#report-verification) · [Explore other KFD verification profiles](/verify/) - Agent Hub: https://kfd.libkungfu.dev/agent-hub/ - Guide: https://kfd.libkungfu.dev/verify/ - implementation-map: https://kfd.libkungfu.dev/evidence/semantic-self-sufficiency/kfd-1-13.json (sha256:893bd12f32a7dab45e954f9dfa4a2cecb36982e1d9a84c5108fbf14d72335b9b) - verification-profile: https://kfd.libkungfu.dev/profiles/warrant-evidence/manifest.json (sha256:1032006a7435408761916de291abc8ee239594e70d739f28c3b29b60da75a755) - evidence-report: https://kfd.libkungfu.dev/evidence/primitive-evidence/first-wave-report.json (sha256:b1f0eb6918f0bf61760a3cadf496c1edb17bab962dcd1a41e2f5875e4b4aa62e) - evidence-report: https://kfd.libkungfu.dev/evidence/primitive-evidence/second-wave-report.json (sha256:b0ed807dee3e93f0e6764c9d7b4b67c2a7da5a7580e169c03811ec3ec0732149) - schema: https://kfd.libkungfu.dev/schemas/kfd-semantic-self-sufficiency-matrix.schema.json (sha256:482fcd5dfdcd78860619f78faedb843357974ea2a21d6f1dc94aca0ac7bacd4f) - Claim boundary: Passing the profile proves only the fixed KFD package cut and retained evidence inputs. It does not activate KFD-10, certify an adopter, authenticate an upstream repository, or prove production fitness. Governed KFD self-change: - Human guide: https://kfd.libkungfu.dev/verify/self-conformance/ - Verification lanes: independent-implementation=https://kfd.libkungfu.dev/verify/, governed-self-change=https://kfd.libkungfu.dev/verify/self-conformance/ - Profile: kfd-self-conformance@1.0.0-alpha.1 [experimental; normative=false] - Candidate: merged; normative=false; number allocated=false - Live case: https://kfd.libkungfu.dev/cases/live/recursive-normative-self-conformance/ [closed; no-new-primitive] - Terminal outcome: non-promotion - Request root: sha256:6de7f6436870f4ac5d0e608e631b787371eb318ff680a15b90db7e5b4aac8dc6 - Fixed package root: sha256:596a1e4b0d57e93fefcb4f32ff2df5be35a56cf86fb8864f5d0ab09b12cd8770 - Terminal bundle root: sha256:1dda7286370c7221d87539d4749fb07017f94238040e324c02fc633c19b797e9 - Terminal report root: sha256:0fb85f2dbd11dba10648bbc85a7f8a563674d4b18c6d6dfe452c6db80b40d9bb - Evaluate a lifecycle gate: kfd gate self-conformance-lifecycle --output --json - Verify a transition report: kfd verify self-conformance-transition --json - Replay immutable historical lineage: node bin/kfd-history.mjs verify profiles/self-conformance/history/historical-lineage.report.json --json - profile-manifest: https://kfd.libkungfu.dev/profiles/self-conformance/manifest.json (sha256:405d367bfc17a466725f792684990f5ee578f81bb65bb3a82b2faf8c65eb9705) - lifecycle-gates: https://kfd.libkungfu.dev/profiles/self-conformance/lifecycle-gates.json (sha256:0ba98836f811dc61aeea36f0635dfb422665ca2d63b9a74131164ecf6d33b241) - verifier-matrix: https://kfd.libkungfu.dev/profiles/self-conformance/lifecycle-gate-matrix.json (sha256:bfd8a790cfbc334d915e2037ff8356a7de76fd455a4ddcdef2f1811d91712af5) - issue-codes: https://kfd.libkungfu.dev/profiles/self-conformance/issue-codes.json (sha256:e5ad0dcb9a5ee4d20853c828fa8435cae96fadf4427e12a4622352647b1633a7) - qualification-assessment: https://kfd.libkungfu.dev/evidence/self-conformance/qualification/recursive-normative-self-conformance.assessment.json (sha256:b61a2fd28bc264baabf206235232fc0e55279b637d72912cd65c3419bfbbcfd7) - independent-verification: https://kfd.libkungfu.dev/evidence/self-conformance/qualification/recursive-normative-self-conformance.verification.json (sha256:c74ac5cfd1206d1fd36e4c1f65125a2bd790a2f7fbab53187595394ea87d8efe) - terminal-transition-report: https://kfd.libkungfu.dev/evidence/self-conformance/transitions/recursive-normative-self-conformance-terminal.report.json (sha256:e4ac94237f2a3a3dd2467a39158f1a8a6b0e0882722a11973d01f12c99ad801a) - historical-lineage: https://kfd.libkungfu.dev/profiles/self-conformance/history/historical-lineage.report.json (sha256:d49fc25d5f1816a4f8b4d68aa78ced0f556a80a315d96520eb09f57273a72c1b) - historical-manifest: https://kfd.libkungfu.dev/profiles/self-conformance/history/manifest.json (sha256:ac5c97fd354eed6b108bc6f498caf0ebcf6cc6add807785e5ba8ee860cc1b9ab) - Release boundary: A valid verifier report is necessary structural evidence. It cannot approve, merge, publish, certify, allocate a number, change status, or authorize a release. - Claim boundary: This page projects the fixed KFD package. Numbered decisions, Profile contracts, exact evidence roots, and accountable human authority remain authoritative. The fixed package proves only the published Self-Conformance contract closure and vectors. It does not prove semantic truth, approval, certification, adoption, product fitness, lifecycle authority, or release authorization. Agent-first entries: - https://kfd.libkungfu.dev/manifest.json - https://kfd.libkungfu.dev/agent-hub/ - https://kfd.libkungfu.dev/registry.json - https://kfd.libkungfu.dev/drafts/registry.json - https://kfd.libkungfu.dev/cases/registry.json - https://kfd.libkungfu.dev/standards.json - https://kfd.libkungfu.dev/terminology.json - https://kfd.libkungfu.dev/schemas/kfd-terminology.schema.json - https://kfd.libkungfu.dev/activation-contracts.json - https://kfd.libkungfu.dev/schemas/kfd-11/adopter-witness.schema.json - https://kfd.libkungfu.dev/schemas/kfd-12/adopter-witness.schema.json - https://kfd.libkungfu.dev/schemas/kfd-13/adopter-witness.schema.json - https://kfd.libkungfu.dev/schemas/kfd-activation/qualification-report.schema.json - https://kfd.libkungfu.dev/schemas/kfd-activation/activation-record.schema.json - https://kfd.libkungfu.dev/evidence/semantic-self-sufficiency/kfd-1-13.json - https://kfd.libkungfu.dev/profiles/warrant-evidence/manifest.json - https://kfd.libkungfu.dev/evidence/primitive-evidence/first-wave-report.json - https://kfd.libkungfu.dev/evidence/primitive-evidence/second-wave-report.json - https://kfd.libkungfu.dev/schemas/kfd-semantic-self-sufficiency-matrix.schema.json - https://kfd.libkungfu.dev/profiles/self-conformance/manifest.json - https://kfd.libkungfu.dev/profiles/self-conformance/lifecycle-gates.json - https://kfd.libkungfu.dev/profiles/self-conformance/lifecycle-gate-matrix.json - https://kfd.libkungfu.dev/profiles/self-conformance/issue-codes.json - https://kfd.libkungfu.dev/evidence/self-conformance/qualification/recursive-normative-self-conformance.assessment.json - https://kfd.libkungfu.dev/evidence/self-conformance/qualification/recursive-normative-self-conformance.verification.json - https://kfd.libkungfu.dev/evidence/self-conformance/transitions/recursive-normative-self-conformance-terminal.report.json - https://kfd.libkungfu.dev/profiles/self-conformance/history/historical-lineage.report.json - https://kfd.libkungfu.dev/profiles/self-conformance/history/manifest.json - https://kfd.libkungfu.dev/verify/self-conformance/ - https://kfd.libkungfu.dev/cases/live/recursive-normative-self-conformance/ - https://kfd.libkungfu.dev/llms.txt Read order: - https://kfd.libkungfu.dev/ - https://kfd.libkungfu.dev/agent-hub/ - https://kfd.libkungfu.dev/decisions/ - https://kfd.libkungfu.dev/foundation/ - https://kfd.libkungfu.dev/concepts/ - https://kfd.libkungfu.dev/verify/ - https://kfd.libkungfu.dev/verify/self-conformance/ - https://kfd.libkungfu.dev/under-load/ - https://kfd.libkungfu.dev/formal/ - https://kfd.libkungfu.dev/terminology/ - https://kfd.libkungfu.dev/terminology.json - https://kfd.libkungfu.dev/schemas/kfd-terminology.schema.json - https://kfd.libkungfu.dev/activation-contracts.json - https://kfd.libkungfu.dev/schemas/kfd-11/adopter-witness.schema.json - https://kfd.libkungfu.dev/schemas/kfd-12/adopter-witness.schema.json - https://kfd.libkungfu.dev/schemas/kfd-13/adopter-witness.schema.json - https://kfd.libkungfu.dev/schemas/kfd-activation/qualification-report.schema.json - https://kfd.libkungfu.dev/schemas/kfd-activation/activation-record.schema.json - https://kfd.libkungfu.dev/evidence/semantic-self-sufficiency/kfd-1-13.json - https://kfd.libkungfu.dev/profiles/warrant-evidence/manifest.json - https://kfd.libkungfu.dev/evidence/primitive-evidence/first-wave-report.json - https://kfd.libkungfu.dev/evidence/primitive-evidence/second-wave-report.json - https://kfd.libkungfu.dev/schemas/kfd-semantic-self-sufficiency-matrix.schema.json - https://kfd.libkungfu.dev/profiles/self-conformance/manifest.json - https://kfd.libkungfu.dev/profiles/self-conformance/lifecycle-gates.json - https://kfd.libkungfu.dev/profiles/self-conformance/lifecycle-gate-matrix.json - https://kfd.libkungfu.dev/profiles/self-conformance/issue-codes.json - https://kfd.libkungfu.dev/evidence/self-conformance/qualification/recursive-normative-self-conformance.assessment.json - https://kfd.libkungfu.dev/evidence/self-conformance/qualification/recursive-normative-self-conformance.verification.json - https://kfd.libkungfu.dev/evidence/self-conformance/transitions/recursive-normative-self-conformance-terminal.report.json - https://kfd.libkungfu.dev/profiles/self-conformance/history/historical-lineage.report.json - https://kfd.libkungfu.dev/profiles/self-conformance/history/manifest.json - https://kfd.libkungfu.dev/cases/ - https://kfd.libkungfu.dev/cases/live/proof-carrying-work-object/ - https://kfd.libkungfu.dev/cases/live/software-work-perspective-settlement/ - https://kfd.libkungfu.dev/cases/live/decision-admission-settlement/ - https://kfd.libkungfu.dev/cases/live/federated-work-continuity/ - https://kfd.libkungfu.dev/cases/live/product-release-cut-transition/ - https://kfd.libkungfu.dev/cases/live/recursive-normative-self-conformance/ - https://kfd.libkungfu.dev/cases/live/durable-result-identity-availability/ - https://kfd.libkungfu.dev/drafts/ - https://kfd.libkungfu.dev/drafts/action-state-separation/ - https://kfd.libkungfu.dev/drafts/atlas-action-perspective/ - https://kfd.libkungfu.dev/drafts/pursuit-intent-continuity/ - https://kfd.libkungfu.dev/drafts/warrant-bounded-authority/ - https://kfd.libkungfu.dev/drafts/claim-assessment-decision-admission/ - https://kfd.libkungfu.dev/drafts/federated-work-continuity/ - https://kfd.libkungfu.dev/drafts/recursive-normative-self-conformance/ - https://kfd.libkungfu.dev/drafts/durable-result-identity-availability/ - https://kfd.libkungfu.dev/drafts/atlas-action-perspective/formal/ - https://kfd.libkungfu.dev/drafts/pursuit-intent-continuity/formal/ - https://kfd.libkungfu.dev/drafts/warrant-bounded-authority/formal/ - https://kfd.libkungfu.dev/drafts/federated-work-continuity/formal/ - https://kfd.libkungfu.dev/1/ - https://kfd.libkungfu.dev/2/ - https://kfd.libkungfu.dev/3/ - https://kfd.libkungfu.dev/4/ - https://kfd.libkungfu.dev/5/ - https://kfd.libkungfu.dev/6/ - https://kfd.libkungfu.dev/7/ - https://kfd.libkungfu.dev/8/ - https://kfd.libkungfu.dev/9/ - https://kfd.libkungfu.dev/10/ - https://kfd.libkungfu.dev/11/ - https://kfd.libkungfu.dev/12/ - https://kfd.libkungfu.dev/13/ - https://kfd.libkungfu.dev/1/usage/ - https://kfd.libkungfu.dev/2/usage/ - https://kfd.libkungfu.dev/3/usage/ - https://kfd.libkungfu.dev/4/usage/ - https://kfd.libkungfu.dev/5/usage/ - https://kfd.libkungfu.dev/6/usage/ - https://kfd.libkungfu.dev/7/usage/ - https://kfd.libkungfu.dev/8/usage/ - https://kfd.libkungfu.dev/9/usage/ - https://kfd.libkungfu.dev/10/usage/ - https://kfd.libkungfu.dev/11/usage/ - https://kfd.libkungfu.dev/12/usage/ - https://kfd.libkungfu.dev/13/usage/ - https://kfd.libkungfu.dev/1/formal/ - https://kfd.libkungfu.dev/2/formal/ - https://kfd.libkungfu.dev/3/formal/ - https://kfd.libkungfu.dev/4/formal/ - https://kfd.libkungfu.dev/5/formal/ - https://kfd.libkungfu.dev/6/formal/ - https://kfd.libkungfu.dev/7/formal/ - https://kfd.libkungfu.dev/8/formal/ - https://kfd.libkungfu.dev/9/formal/ - https://kfd.libkungfu.dev/10/formal/ - https://kfd.libkungfu.dev/11/formal/ - https://kfd.libkungfu.dev/12/formal/ - https://kfd.libkungfu.dev/13/formal/ - https://kfd.libkungfu.dev/registry.json - https://kfd.libkungfu.dev/drafts/registry.json - https://kfd.libkungfu.dev/cases/registry.json - https://kfd.libkungfu.dev/standards.json Source boundary: KFD facts, registry entries, standards metadata, and decision text come from @kungfu-tech/kfd@1.0.0-alpha.67. site-libkungfu-dev owns reader framing and renders and exposes those facts, but does not own or fork their meaning.