{ "schemaVersion": 1, "contract": "core.libkungfu.dev/site-bundle-consumer/v1", "generatedAt": "2026-07-28T15:06:57.000Z", "publishedAt": "2026-07-28T15:06:57.000Z", "reproducible": true, "timestampPolicy": "ci-injected", "deterministicInputs": [ "scripts/render-site.mjs", "scripts/publication-packages.cjs", "src/fixtures/*.json", "src/publication-packages.json", "resolved dogfood immutable snapshot URL and SHA-256", "pnpm-lock.yaml", "@kungfu-tech/buildchain package content", "@kungfu-tech/kfd package content", "@kungfu-tech/site package content", "declared @kungfu-tech/paper-* package content", "sourceRevision", "sourceDateEpoch", "package content", "declared Buildchain surface manifest contract" ], "sourceDateEpoch": "0", "sourceRevision": "be9198f2b0f9dee2a4bee5f051b015a4f48f6af7", "timestampPolicyDetails": { "contract": "kungfu-buildchain-surface-timestamp-policy", "timestampFields": [ "generatedAt", "publishedAt" ], "timestampFieldsParticipateInArtifactDigest": true, "artifactDigestScope": "site dist manifest JSON files", "note": "Human-readable timestamps are separate from reproducibility inputs; do not infer reproducibility from epoch timestamps." }, "canonicalHost": "core.libkungfu.dev", "package": { "name": "@kungfu-tech/site", "version": "4.0.0-alpha.1", "integrity": "sha512-MN3eIIcuVvTwz59U1DpdIVMbQjpDgKJKVncGws9iLJKXK9bhO261Tto8IFfsXT96lAbl65bj6qa67EPJv9vV4g==" }, "bundle": { "contract": "kungfu.site-bundle/v1", "contentRoot": "sha256:8656db9db7f6ffba17b6a137162331c2cf63926eefe452aa94c4c5eb6bc05e69", "sourceRoot": "sha256:83323cb0d2644451ead64772497be591a47338e071e7fe27602d361ffdafdacb", "source": { "repository": "https://github.com/kungfu-systems/kungfu", "revision": "74198a765f8c7d0f69f7e2c848bca935e1f40646", "treeDirty": false, "authorityPolicy": "composition-only; exact upstream paths and content roots remain authoritative", "reproducible": true }, "schemaDigest": "sha256:0cb27d7bfb56086c5667336771f04df539cbf64b4296ee1cadc070915d3477a3" }, "readerContract": { "contract": "libkungfu-dev-reader-contract/v1", "owner": "site-libkungfu-dev", "path": { "id": "core", "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.", "claimClass": "site-synthesis", "sourceRefs": [ "kungfu-site-bundle" ], "authorityLabel": "Explore the product map", "authorityHref": "/", "evidenceLabel": "Inspect the exact bundle", "evidenceHref": "/site-bundle.json" }, "humanEntries": { "overview": "https://core.libkungfu.dev/", "format": "https://core.libkungfu.dev/format/", "primitives": "https://core.libkungfu.dev/primitives/", "runtime": "https://core.libkungfu.dev/runtime/", "abi": "https://core.libkungfu.dev/abi/", "sdk": "https://core.libkungfu.dev/sdk/", "extensions": "https://core.libkungfu.dev/extensions/", "products": "https://core.libkungfu.dev/products/", "qualification": "https://core.libkungfu.dev/qualification/", "decisions": "https://core.libkungfu.dev/decisions/", "horizons": "https://core.libkungfu.dev/horizons/" }, "layers": [ { "id": "first-screen", "label": "First-screen proposition", "owner": "site-libkungfu-dev", "purpose": "Answer why this surface matters to its intended reader before status, registry, or implementation detail." }, { "id": "guided-synthesis", "label": "Guided synthesis", "owner": "site-libkungfu-dev", "purpose": "Connect facts across Kungfu, KFD, and Buildchain without turning the synthesis into a new normative source." }, { "id": "upstream-authority", "label": "Upstream authority", "owner": "kungfu-systems/kungfu, @kungfu-tech/kfd, and @kungfu-tech/buildchain", "purpose": "Supply runtime semantics, protocol decisions, schemas, commands, workflows, and release facts." }, { "id": "machine-evidence", "label": "Machine evidence", "owner": "upstream authorities projected by site-libkungfu-dev", "purpose": "Expose exact sources, versions, digests, qualification, claim boundaries, and stable routes for independent inspection." } ], "sourceBoundary": { "truthOwner": "upstream-evidence-and-manifests", "siteRole": "reader contract, guided synthesis, visual composition, routing, and rendering", "rule": "The site owns first-screen framing, cross-surface synthesis, reading order, progressive disclosure, navigation, and visual composition. Every technical or release claim must bind to immutable upstream evidence or a pinned package; core specs, KFD semantics, CLI parameters, workflow inputs, release state machines, schemas, and provenance remain upstream-owned." } }, "positioning": { "promise": "Kungfu helps a fresh agent continue the same real-world work without asking you to explain it all again.", "firstReleaseOutcome": "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.", "currentFocus": "Accountable agent runtime is the current product focus; quantitative trading is historical proof and games or virtual worlds are a future derivative horizon." }, "adoptionLayers": [ { "id": "format", "label": ".kungfu format and workspace contract", "job": "Inspect the pre-release portable authority, required-reader behavior, version matrix, schema registry, retained vectors, workspace layout and preservation rules.", "notRequired": "GUI, Electron, or a particular language host.", "maturity": "staged", "sourceIds": [ "spec-consumer-contract", "spec-manifest-schema", "product-layers" ] }, { "id": "libkungfu", "label": "libkungfu", "job": "Embed the local truth-source loop, Episode lifecycle, query, verification, export and recovery.", "notRequired": "Python, Node, Rust host, Electron, cloud or database service.", "maturity": "qualified", "sourceIds": [ "product-layers", "abi-boundary", "abi-guide" ] }, { "id": "sdk", "label": "Python, npm and Cargo SDKs", "job": "Use the same native semantics through one idiomatic language ecosystem.", "notRequired": "Sibling SDKs or GUI.", "maturity": "staged", "sourceIds": [ "product-layers", "node-sdk", "rust-sdk", "layer-release" ] }, { "id": "cli-tui", "label": "Standalone CLI and TUI", "job": "Discover, record, query, verify, maintain and export headlessly.", "notRequired": "Electron.", "maturity": "staged", "sourceIds": [ "product-layers", "cli-contract", "tui-package" ] }, { "id": "gui", "label": "GUI", "job": "Run complete supported visual workflows over public lower contracts.", "notRequired": "Knowledge of internal storage or SQL.", "maturity": "qualified", "sourceIds": [ "product-layers", "gui-package", "gui-qualification" ] }, { "id": "app", "label": "Assembled Kungfu App", "job": "Install compatible official layers as one convenience product.", "notRequired": "Use of every bundled layer.", "maturity": "coming-soon", "sourceIds": [ "project-readme", "product-layers", "layer-release" ] } ], "formatAuthority": { "contract": "kungfu.site-format-authority-projection/v1", "projectionPolicy": "exact-byte-copy-from-verified-@kungfu-tech/spec/v1", "package": { "name": "@kungfu-tech/spec", "version": "4.0.0-alpha.1" }, "pickup": { "coordinate": "@kungfu-tech/spec@4.0.0-alpha.1", "packageEntry": "@kungfu-tech/spec", "manifestExport": "manifestPath", "bundledPath": "format/manifest.json", "manifestRoot": "sha256:3d4ccd24f55e3b967a2d13924233bd8e89d3464fb74a2499ee1e67374f1a68ac", "protocol": "sha256:opaque-bytes/v1" }, "formatNamespace": "libkungfu:fact-ledger", "specVersion": "0.1", "status": "pre-release", "normativeRoot": "sha256:1aea26e10e7b142247254513f744b7c7bc5a06e4b65942d90a49ec1a064b9713", "rootProtocol": "sha256:canonical-json/v1", "reproducibility": "canonical-json-sorted-keys-utf8-lf/v1", "conformance": { "status": "qualified-retained-corpus", "release": "v2", "releaseRoot": "sha256:bd03705e65b8df296329e65753a577d5d4aee34a929e5e889ba20c95f9b3463d", "vectorCount": 16 }, "docsUrl": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/spec/CONSUMING.md", "routes": { "overview": { "path": "format/authority.json", "artifactRoot": "sha256:b6130ec9f28633bc46ec5d2a8dbd8ec33563f718c4b875a44b314e2faa82a95e", "byteLength": 6867, "schema": "kungfu.spec.generated-authority/v1", "status": "current-pre-release-authority", "url": "https://core.libkungfu.dev/format/authority.json" }, "readerContract": { "path": "format/reader-matrix.json", "artifactRoot": "sha256:9567d9ac737c7ab621f9aa55d1eebd7e4a16eed1ce7e4d5e79d3d548b85fea82", "byteLength": 5528, "schema": "kungfu.spec.reader-matrix/v1", "status": "current", "url": "https://core.libkungfu.dev/format/reader-matrix.json" }, "versionMatrix": { "path": "format/compatibility.json", "artifactRoot": "sha256:40109e501c244dcc39408d3193f2e7aa4f66989da74de1c85c2b26c59154172e", "byteLength": 6077, "schema": "kungfu.spec.compatibility-map/v1", "status": "current", "url": "https://core.libkungfu.dev/format/compatibility.json" }, "registry": { "path": "format/registry.json", "artifactRoot": "sha256:f28025e5e890b5e0f9d02d648472e621608d3486e0d550f2f58f51c6c63667b7", "byteLength": 8959, "schema": "kungfu.spec.schema-registry/v1", "status": "current-pre-release-authority", "url": "https://core.libkungfu.dev/format/registry.json" }, "vectors": { "path": "format/vectors/index.json", "artifactRoot": "sha256:40a26afcc56ca921af0ad249489d358cb9d49136b877ad5efd74877b88335643", "byteLength": 14425, "schema": "kungfu.spec.vector-index/v1", "status": "qualified-retained-corpus", "url": "https://core.libkungfu.dev/format/vectors/index.json" } }, "nonClaims": [ "The standalone portable format is not declared stable.", "Package semver is not a format compatibility algorithm.", "The historical Spec 0.1 prose is not normative.", "The package is a projection and does not replace its owning sources." ], "manifest": "https://core.libkungfu.dev/format/manifest.json" }, "surfaces": [ { "id": "overview", "label": "Product map", "route": "/", "headline": "Keep durable work continuity while choosing only the Kungfu layer you need.", "summary": "Start from the user outcome, then move through independently adoptable format, native, SDK, headless, visual and assembled products.", "claimClass": "product-framing", "maturity": "coming-soon", "capabilities": [ "Preserve current understanding, omissions, decisions and next action across fresh contexts.", "Expose the same bounded product and evidence map to humans and agents." ], "knownLimits": [ "The first public CLI and stable product release are not claimed available yet." ], "sourceIds": [ "project-readme", "agent-work-state", "product-layers" ], "authorities": [ { "id": "project-readme", "path": "README.md", "role": "product-framing", "contentRoot": "sha256:f298b602f86cfaa447d62c18fc579b8d3c0445d2f3a4911b99ffe56beadc41fd", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/README.md" }, { "id": "agent-work-state", "path": "docs/profiles/agent-work-state.md", "role": "semantic-authority", "contentRoot": "sha256:1e92199537afb31fd4b2a44c634f0335cc725f1884bc500a7a6e7996cb4f4395", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/profiles/agent-work-state.md" }, { "id": "product-layers", "path": "docs/concepts/product-layers.md", "role": "semantic-authority", "contentRoot": "sha256:872c9847065608555ecb418ef1bb7bba2ccac3c47fb8f209c210d40f419fe817", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/concepts/product-layers.md" } ] }, { "id": "format", "label": ".kungfu", "route": "/format/", "headline": "An exact pre-release portable authority bundle, projected without creating a second format truth.", "summary": "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.", "claimClass": "current-contract", "maturity": "staged", "capabilities": [ "Inspect the portable authority overview and exact package pickup coordinate.", "Route required-reader profiles, compatibility tuples, migration ownership and the schema registry.", "Inspect the qualified retained cross-version vector corpus and every rooted artifact without monorepo reach-through.", "Render all eleven integrity-bound human page models directly from the installed package." ], "knownLimits": [ "The standalone portable format is pre-release and is not declared stable.", "Package semver is a pickup coordinate, not a format compatibility algorithm.", "The historical Spec 0.1 prose is non-normative." ], "sourceIds": [ "spec-consumer-contract", "spec-manifest-schema", "spec-readme" ], "authorities": [ { "id": "spec-consumer-contract", "path": "framework/spec/CONSUMING.md", "role": "machine-contract", "contentRoot": "sha256:1a5616fb506db1006a749331d218a8d77410c19ba13ce2344bd53e88bbe71f54", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/spec/CONSUMING.md" }, { "id": "spec-manifest-schema", "path": "framework/spec/schema/manifest.schema.json", "role": "machine-contract", "contentRoot": "sha256:272b75700c2d467bc78ac3d19c1d3d1cfd8d09ec0e1835d1487ab307bfda3391", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/spec/schema/manifest.schema.json" }, { "id": "spec-readme", "path": "framework/spec/README.md", "role": "product-framing", "contentRoot": "sha256:80d93adb4291ca23d1606c7da169c60c9f2754c9d5631870839f82baf11bfe36", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/spec/README.md" } ] }, { "id": "primitives", "label": "Fact, Episode and Action Geometry", "route": "/primitives/", "headline": "Two ontology bindings preserve reality; three action responsibilities keep intent, perspective and authority distinct.", "summary": "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.", "claimClass": "qualified-source", "maturity": "qualified-shadow", "capabilities": [ "Fact: identify admitted state at a declared Cut.", "Episode: retain what actually occurred with causal provenance.", "Pursuit: preserve intended change and success conditions.", "Atlas: preserve perspective, sources, omissions and Cut.", "Warrant: preserve bounded authority for an exact action and state." ], "knownLimits": [ "The runtime is a qualified shadow and does not claim authority cutover or P17 release qualification.", "Episode is not a fourth Action Geometry primitive and occurrence does not prove completion." ], "sourceIds": [ "fact-episode-action", "action-geometry-contract", "agent-work-state" ], "authorities": [ { "id": "fact-episode-action", "path": "docs/architecture/fact-episode-action-runtime.md", "role": "semantic-authority", "contentRoot": "sha256:00fdafd867bcbe784da098209950a15d7f24bf0f1fe5d5ccc9bd6823b89bce9a", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/architecture/fact-episode-action-runtime.md" }, { "id": "action-geometry-contract", "path": "framework/action/action-geometry.contract.json", "role": "machine-contract", "contentRoot": "sha256:7714576ce33208544ca8a9ee1869ad988d815c07dacbf9e136e0475ce2fb9793", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/action/action-geometry.contract.json" }, { "id": "agent-work-state", "path": "docs/profiles/agent-work-state.md", "role": "semantic-authority", "contentRoot": "sha256:1e92199537afb31fd4b2a44c634f0335cc725f1884bc500a7a6e7996cb4f4395", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/profiles/agent-work-state.md" } ] }, { "id": "runtime", "label": "Runtime", "route": "/runtime/", "headline": "Append once, observe live, and recover from the same retained evidence path.", "summary": "The mmap journal, typed storage services, Fact and Episode operations, projections and explicit durability frontiers form the native runtime mechanism.", "claimClass": "implemented-source", "maturity": "qualified", "capabilities": [ "Ordered append and zero-copy observation over the journal.", "Fact admission, Episode lifecycle, historical query, verification, export and recovery.", "Explicit visibility, commit and durability frontiers rather than one ambiguous success state." ], "knownLimits": [ "Visibility is not durability; strong durability candidates are separately admitted and not the default universal claim.", "Replication, high availability, arbitrary side-effect recovery and battle-tested external adoption are not claimed." ], "presentation": { "kicker": "libkungfu runtime substrate", "architecture": { "label": "One journal, four local views", "writer": { "label": "Agent worker", "detail": "Appends action, lifecycle and telemetry frames once." }, "journal": { "label": "Append-only mmap Episode journal", "detail": "One published frame stream is retained evidence and the local reader bus.", "qualifier": "single writer ยท many local readers", "frames": [ "action", "tool I/O", "tokens", "telemetry" ] }, "readers": [ { "id": "live-tail", "label": "Hub live tail", "detail": "Observe published frames without a second event pipeline.", "status": "integration pattern" }, { "id": "supervisor", "label": "Supervisor", "detail": "Read heartbeat and progress without interrupting the worker.", "status": "integration pattern" }, { "id": "rewind", "label": "Rewind and replay", "detail": "Reopen retained evidence at a qualified frontier.", "status": "implemented in qualified slices" }, { "id": "fanout", "label": "Local readers", "detail": "Fan out one published stream to co-located consumers.", "status": "implemented substrate" } ] }, "outcomes": [ { "title": "Storage is the bus", "summary": "The journal is not copied into a second transport just to become observable. Retained frames are the local read surface." }, { "title": "Observation stays off the writer path", "summary": "Readers attach to published mmap pages, so each observer does not require a new writer-side copy or broker hop." }, { "title": "Recovery starts from retained truth", "summary": "After failure, resume from the last qualified published or durable frontier and classify any unacknowledged tail explicitly." } ], "semanticBoundary": { "heading": "Frames record what happened. Policy decides what it means.", "body": "The journal carries ordered evidence. KFD and each Hub's local policy define authority, admission, completion and what may safely happen next.", "invariants": [ "Delivery is not admission.", "Occurrence is not completion.", "Authentication is not authority." ], "kfdUrl": "https://kfd.libkungfu.dev/" }, "frontiers": [ { "id": "visible", "label": "visible", "status": "implemented", "summary": "A complete frame is published and available to declared live readers." }, { "id": "durable-group", "label": "durable_group", "status": "candidate-qualified", "summary": "A frame is at or below a selected batch durable watermark. Production durable ingest remains disabled by default." }, { "id": "durable-sync", "label": "durable_sync", "status": "candidate-qualified", "summary": "Required data and metadata cross a named local durability barrier. Production durable ingest remains disabled by default." }, { "id": "replicated", "label": "replicated", "status": "future", "summary": "A separate replication policy acknowledges the frame; this is not a current implementation target." } ], "qualificationClaims": [ "The mmap MAP_SHARED publish barrier is implemented for a single writer and multiple cross-process readers.", "The production mapping profile currently qualifies visibility; durable requests remain fail closed unless a named candidate path is selected.", "The current reference Hub adapter carries lifecycle metadata, not prompt, tool, token, provider payloads or private journal bytes.", "The wider visible typed-agent and multi-reader product surfaces remain separate end-to-end admission work." ] }, "sourceIds": [ "product-layers", "mmap-decision", "durability-qualification", "abi-boundary" ], "authorities": [ { "id": "product-layers", "path": "docs/concepts/product-layers.md", "role": "semantic-authority", "contentRoot": "sha256:872c9847065608555ecb418ef1bb7bba2ccac3c47fb8f209c210d40f419fe817", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/concepts/product-layers.md" }, { "id": "mmap-decision", "path": "docs/adr/KF-ADR-019f86da-4f90-7f8a-9bff-e4f7683da35f.md", "role": "semantic-authority", "contentRoot": "sha256:dce8d379f4bd7f4800f9141ac2f1a5e9a8365c526733adef4eed007895f40e84", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/adr/KF-ADR-019f86da-4f90-7f8a-9bff-e4f7683da35f.md" }, { "id": "durability-qualification", "path": "docs/qualification/durability-and-crash-recovery.md", "role": "qualification-evidence", "contentRoot": "sha256:e7a72bb6bd9f5f12e29fbe568537f2fe580b3ae04d08547f9bb30b85172d581a", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/qualification/durability-and-crash-recovery.md" }, { "id": "abi-boundary", "path": "docs/architecture/kfd7-library-boundary.md", "role": "semantic-authority", "contentRoot": "sha256:bbbc8c0edef41af765179b2c405f2605ec3b859362c29becdc79b75bcadfb1dd", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/architecture/kfd7-library-boundary.md" } ] }, { "id": "abi", "label": "Native ABI", "route": "/abi/", "headline": "One public bootstrap discovers separately versioned responsibility interfaces.", "summary": "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.", "claimClass": "qualified-source", "maturity": "qualified", "capabilities": [ "Negotiate ABI and interface versions without a language host.", "Use owner-thread contexts, token-bounded results and explicit release.", "Call stream, ledger-action and maintenance responsibilities behind one export." ], "knownLimits": [ "JSON is the named v1 edge encoding, not Root identity.", "Timeout is reserved in v1; cancellation is cooperative and does not preempt an admitted one-shot call.", "libyijinjing has no shared ABI and Node is not a successor ABI reference wrapper." ], "sourceIds": [ "abi-boundary", "abi-guide", "api-header" ], "authorities": [ { "id": "abi-boundary", "path": "docs/architecture/kfd7-library-boundary.md", "role": "semantic-authority", "contentRoot": "sha256:bbbc8c0edef41af765179b2c405f2605ec3b859362c29becdc79b75bcadfb1dd", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/architecture/kfd7-library-boundary.md" }, { "id": "abi-guide", "path": "docs/guides/libkungfu-abi-consumer.md", "role": "semantic-authority", "contentRoot": "sha256:67e32143c7e69bb3960d2d8be1f76699e5734df8dc9a178e2a302a51117adf5f", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/guides/libkungfu-abi-consumer.md" }, { "id": "api-header", "path": "framework/core/src/libkungfu/include/kungfu/api.h", "role": "machine-contract", "contentRoot": "sha256:84d9265adbdc3d117b0d9d01ee36510985f974892e7430fbdcd5e1da530d1c19", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/core/src/libkungfu/include/kungfu/api.h" } ] }, { "id": "sdk", "label": "SDKs", "route": "/sdk/", "headline": "C/C++, Python, Node and Rust remain thin surfaces over one native authority.", "summary": "Each ecosystem package can qualify independently through clean install, capability discovery, the shared semantic fixture and the same .kungfu evidence path.", "claimClass": "implemented-source", "maturity": "staged", "capabilities": [ "C and C++ consume the installed Kungfu::kungfu coordinate.", "Python and Rust start at kungfu_get_api and negotiate responsibility tables.", "Node exposes the versioned storage contract over its current in-process native adapter." ], "knownLimits": [ "Source and artifact gates do not themselves prove current public registry publication.", "Stable compatibility and external adoption remain separate release claims." ], "sourceIds": [ "abi-guide", "node-sdk", "rust-sdk", "layer-release" ], "authorities": [ { "id": "abi-guide", "path": "docs/guides/libkungfu-abi-consumer.md", "role": "semantic-authority", "contentRoot": "sha256:67e32143c7e69bb3960d2d8be1f76699e5734df8dc9a178e2a302a51117adf5f", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/guides/libkungfu-abi-consumer.md" }, { "id": "node-sdk", "path": "framework/storage/README.md", "role": "product-framing", "contentRoot": "sha256:187ca5846ef808eb41ab15e9b04f78c2c9db65840732a5db0e1d7868e02ba054", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/storage/README.md" }, { "id": "rust-sdk", "path": "crates/kungfu-sdk/README.md", "role": "product-framing", "contentRoot": "sha256:c77c80fb73486026ea1bf4ea1b88adfb49cf60f57feec3da10e2fd67be1e2a5f", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/crates/kungfu-sdk/README.md" }, { "id": "layer-release", "path": "docs/qualification/layer-product-release-qualification.md", "role": "release-policy", "contentRoot": "sha256:ac656c090a11498284c49c348ebef3ae8bb40ecbb7759f3244e89d013d07acea", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/qualification/layer-product-release-qualification.md" } ] }, { "id": "extensions", "label": "KFX and Domain Profiles", "route": "/extensions/", "headline": "Extensions add views, adapters, services and domain meaning without minting Core authority.", "summary": "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.", "claimClass": "implemented-source", "maturity": "staged", "capabilities": [ "Discover view, adapter and service facets from explicit roots.", "Plan trusted or confined execution before instantiating a guest.", "Validate declarative Domain Profiles and preserve five inspectable responsibilities." ], "knownLimits": [ "Native KFX registry mutation, attestation, admission and activation remain staged.", "A valid Domain Profile declaration is not an installed or active signed Profile Suite.", "Current language bindings do not claim equal Domain Profile lifecycle coverage." ], "sourceIds": [ "kfx-topology", "kfx-contract", "domain-profile", "profile-contract" ], "authorities": [ { "id": "kfx-topology", "path": "docs/architecture/kfx-topology.md", "role": "semantic-authority", "contentRoot": "sha256:5b4fd1179ebb42c84a9008ecd0ff94fb01fc62839f3191ddc279640ebb15051c", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/architecture/kfx-topology.md" }, { "id": "kfx-contract", "path": "framework/kfx/kungfu-kfx.contract.json", "role": "machine-contract", "contentRoot": "sha256:09461dda185e075d08137b51d8fcada3e862ff8e4f3cecd725ec7410021bbb99", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/kfx/kungfu-kfx.contract.json" }, { "id": "domain-profile", "path": "docs/architecture/domain-profile-authoring.md", "role": "semantic-authority", "contentRoot": "sha256:e944bb9fea192342252734ceb19fbcdfd0bd638770030e7fa919802d964b3c94", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/architecture/domain-profile-authoring.md" }, { "id": "profile-contract", "path": "framework/profile/kungfu-domain-profile-authoring.contract.json", "role": "machine-contract", "contentRoot": "sha256:3ca9675f02c82adbb0702c7b74c62107f8c0524816a90571da03778d09d5f46f", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/profile/kungfu-domain-profile-authoring.contract.json" } ] }, { "id": "products", "label": "CLI, TUI, GUI and App", "route": "/products/", "headline": "Headless and human products add complete workflows while lower layers retain semantic authority.", "summary": "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.", "claimClass": "product-framing", "maturity": "coming-soon", "capabilities": [ "Operate semantic workflows headlessly without Electron.", "Render complete visual workflows over public capability contracts.", "Install compatible official layers together without collapsing their independent qualifications." ], "knownLimits": [ "The public install path remains coming soon.", "Current GUI qualification is bounded to the named macOS arm64 candidate and does not prove interactive pixel correctness or all platforms." ], "sourceIds": [ "project-readme", "product-layers", "cli-contract", "tui-package", "gui-package", "gui-qualification" ], "authorities": [ { "id": "project-readme", "path": "README.md", "role": "product-framing", "contentRoot": "sha256:f298b602f86cfaa447d62c18fc579b8d3c0445d2f3a4911b99ffe56beadc41fd", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/README.md" }, { "id": "product-layers", "path": "docs/concepts/product-layers.md", "role": "semantic-authority", "contentRoot": "sha256:872c9847065608555ecb418ef1bb7bba2ccac3c47fb8f209c210d40f419fe817", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/concepts/product-layers.md" }, { "id": "cli-contract", "path": "framework/core/src/python/kungfu/cli/surface_contract.registry.json", "role": "machine-contract", "contentRoot": "sha256:dc2c68d6d9eb759ff3622c30e6ee2bc529431a0f1afa7e5a012bf6c9c5aca821", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/core/src/python/kungfu/cli/surface_contract.registry.json" }, { "id": "tui-package", "path": "framework/tui/package.json", "role": "product-framing", "contentRoot": "sha256:6d32cb84b77c95de27be1fe3c8438b54c4c7c8fddc98b05a05236382608ace75", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/tui/package.json" }, { "id": "gui-package", "path": "framework/gui/package.json", "role": "product-framing", "contentRoot": "sha256:9a91ecce5c44a3035911f79c0f6adb9b6451672107bfde488efb10b009e6d698", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/framework/gui/package.json" }, { "id": "gui-qualification", "path": "docs/qualification/gui-capability-boundary.md", "role": "qualification-evidence", "contentRoot": "sha256:8bc54b45941f678baa96b40aefb003f1b2d8f4993dd90fb38ba0929a7006b358", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/qualification/gui-capability-boundary.md" } ] }, { "id": "qualification", "label": "Qualification and release", "route": "/qualification/", "headline": "Design intent, implementation, qualification and publication are different claims.", "summary": "Source acceptance and platform artifact gates bind exact evidence; public coordinates, signing and stable compatibility require their own release and publication proof.", "claimClass": "qualified-source", "maturity": "staged", "capabilities": [ "Qualify format, SDK, CLI/TUI, GUI and assembled product rows independently.", "Bind exact source revisions, artifact digests, platform evidence and known limits.", "Fail closed when evidence, budgets, publication coordinates or source cleanliness are missing." ], "knownLimits": [ "A passing source-built gate is not a publication claim.", "A Gate receipt never publishes, tags, signs or promotes an artifact." ], "sourceIds": [ "layer-release", "known-limits", "gui-qualification" ], "authorities": [ { "id": "layer-release", "path": "docs/qualification/layer-product-release-qualification.md", "role": "release-policy", "contentRoot": "sha256:ac656c090a11498284c49c348ebef3ae8bb40ecbb7759f3244e89d013d07acea", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/qualification/layer-product-release-qualification.md" }, { "id": "known-limits", "path": "docs/qualification/known-limits.md", "role": "qualification-evidence", "contentRoot": "sha256:8ef7f5c12c232f24ae6a1e3b26ad617a17989bc0c73e46412efec594e8108af8", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/qualification/known-limits.md" }, { "id": "gui-qualification", "path": "docs/qualification/gui-capability-boundary.md", "role": "qualification-evidence", "contentRoot": "sha256:8bc54b45941f678baa96b40aefb003f1b2d8f4993dd90fb38ba0929a7006b358", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/qualification/gui-capability-boundary.md" } ] }, { "id": "decisions", "label": "ADR map", "route": "/decisions/", "headline": "Browse the complete decision corpus by domain, authority edge and bounded neighborhood.", "summary": "The human mind map and machine projection are generated from ADR frontmatter and the audited corpus; inferred nearby links are navigation-only.", "claimClass": "current-contract", "maturity": "implemented", "capabilities": [ "Browse all ADRs across deterministic product and architecture domains.", "Follow authoritative supersedes edges separately from inferred nearby links.", "Inspect decision, implementation, review and qualification-reference status." ], "knownLimits": [ "Domain membership and nearby links do not create architecture authority.", "Xinfa remains the impact, dependency and stale-state authority." ], "sourceIds": [ "adr-map" ], "authorities": [ { "id": "adr-map", "path": "docs/architecture/adr-map.json", "role": "navigation-projection", "contentRoot": "sha256:7d6dd49082f598b19ee21da5d0dec342fe9cd2f9c82492113eca2d22531ab1f2", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/architecture/adr-map.json" } ] }, { "id": "horizons", "label": "Domain horizons", "route": "/horizons/", "headline": "One domain-neutral core, one current product focus, and bounded evidence or future horizons.", "summary": "Quantitative trading supplies historical pressure evidence, accountable agent runtime is the current focus, and games or virtual worlds remain a future derivative design witness.", "claimClass": "future-horizon", "maturity": "current-focus", "capabilities": [ "Keep ordered facts, causality, Episodes, cuts, query and verification domain-neutral.", "Add domain meaning through Profiles and adapters rather than forking the kernel." ], "knownLimits": [ "The horizon map is not three simultaneous product roadmaps.", "Games and virtual worlds are not an active product line without a bounded validation gate." ], "sourceIds": [ "domain-horizons", "product-layers" ], "authorities": [ { "id": "domain-horizons", "path": "docs/concepts/domain-horizons.md", "role": "product-framing", "contentRoot": "sha256:8905b68d4780e4f67c5762a5acf50a9e61bdf80cc07d3e26dd67d3fdc7ea917a", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/concepts/domain-horizons.md" }, { "id": "product-layers", "path": "docs/concepts/product-layers.md", "role": "semantic-authority", "contentRoot": "sha256:872c9847065608555ecb418ef1bb7bba2ccac3c47fb8f209c210d40f419fe817", "url": "https://github.com/kungfu-systems/kungfu/blob/74198a765f8c7d0f69f7e2c848bca935e1f40646/docs/concepts/product-layers.md" } ] } ], "nonClaims": [ "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." ], "adrMap": { "contract": "kungfu.adr-navigation-projection/v1", "path": "adr-map.json", "contentRoot": "sha256:7d6dd49082f598b19ee21da5d0dec342fe9cd2f9c82492113eca2d22531ab1f2", "summary": { "records": 156, "domains": 8, "authoritativeEdges": 2, "inferredNavigationEdges": 548 }, "authorityBoundary": "Only ADR-frontmatter relations are authoritative; domains and nearby links are deterministic navigation-only projections." }, "machineEntries": { "manifest": "https://core.libkungfu.dev/manifest.json", "bundle": "https://core.libkungfu.dev/site-bundle.json", "agentIndex": "https://core.libkungfu.dev/agent-index.json", "adrMap": "https://core.libkungfu.dev/adr-map.json", "schema": "https://core.libkungfu.dev/schema/site-bundle.schema.json", "formatManifest": "https://core.libkungfu.dev/format/manifest.json", "formatReaderContract": "https://core.libkungfu.dev/format/reader-matrix.json", "formatVersionMatrix": "https://core.libkungfu.dev/format/compatibility.json", "formatRegistry": "https://core.libkungfu.dev/format/registry.json", "formatVectors": "https://core.libkungfu.dev/format/vectors/index.json", "llms": "https://core.libkungfu.dev/llms.txt", "full": "https://core.libkungfu.dev/llms-full.txt" } }