# core.libkungfu.dev product map Reader contract: libkungfu-dev-reader-contract/v1 Audience: Kungfu adopters and runtime builders Question: Which Kungfu layer solves the continuity problem I have now? Promise: Start with the complete product map, adopt only the layer you need, and inspect every maturity and authority boundary. Product promise: Kungfu helps a fresh agent continue the same real-world work without asking you to explain it all again. First release outcome: Keep the work when the chat ends. Status: The portable Spec and site bundles are qualified at 4.0.0-alpha.1; the complete product, public CLI and stable compatibility remain separate release claims. Principle: One core, many complete products. Higher layers add convenience, never authority. Product layers: - .kungfu format and workspace contract [staged]: Inspect the pre-release portable authority, required-reader behavior, version matrix, schema registry, retained vectors, workspace layout and preservation rules. Does not require: GUI, Electron, or a particular language host. - libkungfu [qualified]: Embed the local truth-source loop, Episode lifecycle, query, verification, export and recovery. Does not require: Python, Node, Rust host, Electron, cloud or database service. - Python, npm and Cargo SDKs [staged]: Use the same native semantics through one idiomatic language ecosystem. Does not require: Sibling SDKs or GUI. - Standalone CLI and TUI [staged]: Discover, record, query, verify, maintain and export headlessly. Does not require: Electron. - GUI [qualified]: Run complete supported visual workflows over public lower contracts. Does not require: Knowledge of internal storage or SQL. - Assembled Kungfu App [coming-soon]: Install compatible official layers as one convenience product. Does not require: Use of every bundled layer. Surfaces: - / Product map [coming-soon; product-framing]: Start from the user outcome, then move through independently adoptable format, native, SDK, headless, visual and assembled products. - /format/ .kungfu [staged; current-contract]: The site binds @kungfu-tech/spec@4.0.0-alpha.1, its normative root, v4 alpha baseline and artifact roots while the owning format, reader, migration, schema and vector contracts retain semantic authority. - /primitives/ Fact, Episode and Action Geometry [qualified-shadow; qualified-source]: Fact preserves admitted state at an explicit Cut. Episode preserves realized causal occurrence. Pursuit, Atlas and Warrant are Action Geometry responsibilities expressed over exact Facts. - /runtime/ Runtime [qualified; implemented-source]: The mmap journal, typed storage services, Fact and Episode operations, projections and explicit durability frontiers form the native runtime mechanism. - /abi/ Native ABI [qualified; qualified-source]: KFD-7 standardizes kungfu_get_api with discovery, stream, ledger-action and maintenance v1 tables, stable numeric statuses and explicit protocol, schema and encoding fields. - /sdk/ SDKs [staged; implemented-source]: Each ecosystem package can qualify independently through clean install, capability discovery, the shared semantic fixture and the same .kungfu evidence path. - /extensions/ KFX and Domain Profiles [staged; implemented-source]: KFX uses shared discovery and load planning across GUI and CLI hosts; Domain Profiles map adopter-specific objects and policy onto Fact, Episode and Action Geometry responsibilities. - /products/ CLI, TUI, GUI and App [coming-soon; product-framing]: The CLI/TUI is the complete headless product, the GUI is the complete visual product, and the assembled App is the one-install convenience product. - /qualification/ Qualification and release [staged; qualified-source]: Source acceptance and platform artifact gates bind exact evidence; public coordinates, signing and stable compatibility require their own release and publication proof. - /decisions/ ADR map [implemented; current-contract]: The human mind map and machine projection are generated from ADR frontmatter and the audited corpus; inferred nearby links are navigation-only. - /horizons/ Domain horizons [current-focus; future-horizon]: Quantitative trading supplies historical pressure evidence, accountable agent runtime is the current focus, and games or virtual worlds remain a future derivative design witness. Portable format authority: - human definition: .kungfu is a portable, verifiable record of real work. - why it exists: Keep the work, not just the conversation. A folder keeps files. A transcript keeps words. Neither reliably tells the next agent what actually happened, which information was trusted, which outputs belong to the work, or how to check them. .kungfu keeps those relationships together. - handoff: How a fresh agent continues the same work Work: An agent performs a bounded piece of real work and produces facts, artifacts and evidence. Retain: .kungfu keeps the Episode and its verification material together instead of leaving context scattered across a chat and a folder. Continue: A fresh agent can inspect what is known, preserve material it does not yet understand, and act only when the required semantics are compatible. - safe reader behavior: Not understanding something is different from losing it. Preserve: Keep unfamiliar but well-formed material as exact bytes without pretending to understand it. Inspect: Read structure and verification evidence within the reader's declared capability. Act: Deriving canonical state, admitting it as trusted, or executing it requires complete compatible semantics. - current boundary: Qualified does not mean stable. This packaged format authority is qualified but still pre-release. It proves the current contract and retained test corpus; it does not promise stable compatibility or automatic understanding of every future format. - pickup: @kungfu-tech/spec@4.0.0-alpha.1 - status: pre-release - normative root: sha256:1aea26e10e7b142247254513f744b7c7bc5a06e4b65942d90a49ec1a064b9713 - reader rule: Preservation, structural inspection, and semantic authority are distinct capabilities. Unsupported semantics may remain exact bytes, but they never enter canonical fold, admission, or execution. - compatibility rule: Compatibility is decided per authority and then composed against an explicit reader profile; no highest, latest, or package version may stand in for all axes. - retained corpus: v2 / 16 vectors / sha256:bd03705e65b8df296329e65753a577d5d4aee34a929e5e889ba20c95f9b3463d - overview: https://core.libkungfu.dev/format/authority.json [sha256:b6130ec9f28633bc46ec5d2a8dbd8ec33563f718c4b875a44b314e2faa82a95e] - readerContract: https://core.libkungfu.dev/format/reader-matrix.json [sha256:9567d9ac737c7ab621f9aa55d1eebd7e4a16eed1ce7e4d5e79d3d548b85fea82] - versionMatrix: https://core.libkungfu.dev/format/compatibility.json [sha256:40109e501c244dcc39408d3193f2e7aa4f66989da74de1c85c2b26c59154172e] - registry: https://core.libkungfu.dev/format/registry.json [sha256:f28025e5e890b5e0f9d02d648472e621608d3486e0d550f2f58f51c6c63667b7] - vectors: https://core.libkungfu.dev/format/vectors/index.json [sha256:40a26afcc56ca921af0ad249489d358cb9d49136b877ad5efd74877b88335643] Global non-claims: - The standalone portable format is pre-release and is not declared stable. - Package semver is not a format compatibility algorithm. - The historical Spec 0.1 prose is non-normative. - Qualified-shadow Fact, Episode and Action Geometry work does not prove P17 release qualification or authority cutover. - Source-built SDK and product qualification does not prove current public package availability or stable compatibility. - Replication, high availability, arbitrary external-side-effect recovery and battle-tested external adoption are not claimed. - KFX discovery or a valid Domain Profile declaration is not installed, admitted or active extension authority. - The ADR map's inferred domain and nearby edges are navigation only. - Quantitative trading, accountable agent runtime and games are not three simultaneous active product roadmaps. Pinned package: - @kungfu-tech/site@4.0.0-alpha.1 - integrity: sha512-MN3eIIcuVvTwz59U1DpdIVMbQjpDgKJKVncGws9iLJKXK9bhO261Tto8IFfsXT96lAbl65bj6qa67EPJv9vV4g== - bundle content root: sha256:8656db9db7f6ffba17b6a137162331c2cf63926eefe452aa94c4c5eb6bc05e69 - source root: sha256:83323cb0d2644451ead64772497be591a47338e071e7fe27602d361ffdafdacb - source revision: 74198a765f8c7d0f69f7e2c848bca935e1f40646 Machine entries: - https://core.libkungfu.dev/manifest.json - https://core.libkungfu.dev/site-bundle.json - https://core.libkungfu.dev/agent-index.json - https://core.libkungfu.dev/adr-map.json - https://core.libkungfu.dev/schema/site-bundle.schema.json - https://core.libkungfu.dev/format/manifest.json - https://core.libkungfu.dev/format/reader-matrix.json - https://core.libkungfu.dev/format/compatibility.json - https://core.libkungfu.dev/format/registry.json - https://core.libkungfu.dev/format/vectors/index.json - https://core.libkungfu.dev/llms.txt - https://core.libkungfu.dev/llms-full.txt