cks-runtime 0.1.2__py3-none-any.whl

cks_runtime-0.1.2.dist-info/METADATA

@@ -0,0 +1,306 @@
+Metadata-Version: 2.4
+Name: cks-runtime
+Version: 0.1.2
+Summary: Canonical Runtime for the Canonical Knowledge Structure ecosystem
+Author: Vladyslav Hruznov
+License: MIT
+Project-URL: Homepage, https://github.com/Deus-corp/cks-runtime
+Project-URL: Repository, https://github.com/Deus-corp/cks-runtime
+Project-URL: Issues, https://github.com/Deus-corp/cks-runtime/issues
+Keywords: canonical-knowledge-structure,runtime,knowledge-runtime,transactions,sessions,versioning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# CKS Runtime
+
+> The canonical operational environment for Canonical Knowledge Structures.
+
+![Python](https://img.shields.io/badge/python-3.11%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Status](https://img.shields.io/badge/status-alpha-orange)
+
+CKS Runtime is the canonical execution environment for
+Canonical Knowledge Structures (CKS).
+
+Where **CKS Core** defines the semantics of knowledge,
+**CKS Runtime** defines its operational lifecycle.
+
+Runtime provides the infrastructure required to execute,
+manage, version, persist and expose Canonical Knowledge Structures
+without becoming a semantic authority itself.
+
+---
+
+# Why Runtime?
+
+Canonical knowledge is immutable.
+
+Operational state is not.
+
+Applications need to:
+
+- create sessions
+- execute transactions
+- maintain history
+- persist state
+- expose APIs
+- coordinate diagnostics
+
+These responsibilities belong to Runtime rather than CKS Core.
+
+```
+Canonical Knowledge Structure
+            │
+            ▼
+        CKS Runtime
+            │
+ ┌──────────┼──────────┐
+ ▼          ▼          ▼
+Session  Versioning  Storage
+```
+
+Runtime manages operational behaviour.
+
+CKS Core defines semantic behaviour.
+
+---
+
+# Core Principles
+
+CKS Runtime is founded on four architectural principles.
+
+### Runtime is not a semantic authority.
+
+Semantic meaning permanently belongs to CKS Core.
+
+Runtime never redefines knowledge.
+
+---
+
+### Runtime orchestrates semantic services.
+
+Validation.
+
+Evolution.
+
+Serialization.
+
+Diagnostics.
+
+These services originate from CKS Core.
+
+Runtime coordinates their execution.
+
+---
+
+### Operational state belongs to Runtime.
+
+Sessions.
+
+Transactions.
+
+Persistence.
+
+Version History.
+
+These are Runtime responsibilities.
+
+---
+
+### Observable behaviour is standardized.
+
+The Runtime Standard specifies observable operational behaviour rather than implementation techniques.
+
+---
+
+# Runtime Architecture
+
+The CKS ecosystem is organized into four architectural layers.
+
+```
+Applications
+        │
+        ▼
+Adapters
+        │
+        ▼
+CKS Runtime
+        │
+        ▼
+Public CKS Core API
+        │
+        ▼
+CKS Core
+```
+
+Responsibilities are strictly separated.
+
+| Layer | Responsibility |
+|--------|----------------|
+| CKS Core | Semantic authority |
+| CKS Runtime | Operational orchestration |
+| Adapters | Protocol exposure |
+| Applications | Business logic |
+
+---
+
+# Features
+
+The current Reference Runtime provides:
+
+- Runtime Sessions
+- Transaction Management
+- Version History
+- Storage Abstraction
+- Runtime Diagnostics
+- Explainability Coordination
+- Canonical Runtime API
+- Reference Runtime Architecture
+- Runtime Conformance Model
+
+---
+
+# Design Goals
+
+CKS Runtime is designed to be:
+
+- deterministic
+- implementation-independent
+- transport-independent
+- storage-independent
+- session-oriented
+- transaction-oriented
+- semantically neutral
+
+---
+
+# Relationship to CKS Core
+
+CKS Runtime depends upon CKS Core.
+
+CKS Runtime never replaces CKS Core.
+
+```
+CKS Core
+    defines semantics
+
+        │
+
+        ▼
+
+CKS Runtime
+    orchestrates semantics
+    manages operational lifecycle
+```
+
+Runtime communicates exclusively through the public CKS Core API.
+
+---
+
+# Installation
+
+From PyPI:
+
+```bash
+pip install cks-core
+pip install cks-runtime
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/Deus-corp/cks-runtime.git
+
+cd cks-runtime
+
+pip install -e .
+```
+
+---
+
+# Quick Example
+
+```python
+from cks_runtime import Runtime
+
+runtime = Runtime()
+
+session = runtime.sessions.create(
+    knowledge_structure=my_structure
+)
+
+transaction = runtime.transactions.begin(session)
+
+# Runtime coordinates execution.
+# CKS Core defines semantics.
+```
+
+---
+
+# Documentation
+
+The Runtime Standard consists of the following normative specifications.
+
+| Specification | Purpose |
+|--------------|---------|
+| SPEC-001 | Runtime Overview |
+| SPEC-002 | Session Model |
+| SPEC-003 | Runtime API |
+| SPEC-004 | Diagnostics |
+| SPEC-005 | Transactions |
+| SPEC-006 | Storage |
+| SPEC-007 | Version History |
+| SPEC-008 | Runtime Conformance |
+
+Supporting documents include:
+
+- Runtime Charter
+- Architectural Analyses
+- Architecture Decision Records
+- Reference Architecture
+
+---
+
+# Project Status
+
+Current implementation status:
+
+| Component | Status |
+|----------|--------|
+| Runtime Architecture | ✅ Complete |
+| Session Model | ✅ Complete |
+| Transaction Model | ✅ Complete |
+| Version History | ✅ Complete |
+| Diagnostics | ✅ Complete |
+| Storage Abstraction | ✅ Complete |
+| Runtime API | ✅ Complete |
+| Runtime Documentation | ✅ Complete |
+| Reference Implementation | 🚧 In Progress |
+| Adapter Integration | ⏳ Planned |
+
+---
+
+# Long-Term Vision
+
+CKS Runtime aims to become the canonical operational foundation shared by every CKS-compatible implementation.
+
+Future adapter standards—including MCP, CLI, HTTP and others—will rely on Runtime rather than communicating directly with CKS Core.
+
+This preserves a single semantic authority while allowing unlimited operational implementations.
+
+---
+
+# License
+
+MIT

cks_runtime-0.1.2.dist-info/RECORD

@@ -0,0 +1,29 @@
+cks_runtime/__init__.py,sha256=3cxooLDux7C0qZlv1QCabubhVu_nt7N40XqnAZpBWCY,135
+cks_runtime/config.py,sha256=Ye5Zo4CjCGIcf7ZscqIaLpOoy7gQ1fAqJGSNNV4232o,350
+cks_runtime/runtime.py,sha256=eQUmtEzMp3r4vC1swddj__W8-AJFPYBZEb9Udsnw62Y,1607
+cks_runtime/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/core_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/core_api/interfaces.py,sha256=fKajxfDfnU-RLedMIKBA40EIMB1E0V-fovPqXW5v0Bw,1594
+cks_runtime/diagnostics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/diagnostics/aggregator.py,sha256=rkYMgOqPPACrCXQwfsitwaL566X3vp7Qpyle0XpUxSs,1839
+cks_runtime/diagnostics/diagnostic.py,sha256=X03gXaltEP3NfrwKfPAZTtt7XKQY3z4UCtF6ADZrTO8,1240
+cks_runtime/explainability/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/explainability/explainability_manager.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/session/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/session/session.py,sha256=mMInXx0XCUSDedx17HOV2SBxRREmM4nu95sygP6vn0o,1470
+cks_runtime/session/session_manager.py,sha256=oR28jiEw1EqxKRYnjdTP--VpkJBi6H8apiYo518EtTE,1769
+cks_runtime/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/storage/exceptions.py,sha256=SAHbwfGd4wDoCTGuN5r93jNeC9reram_enk6mX1Z9YM,720
+cks_runtime/storage/memory_storage.py,sha256=5XSaW2sYAvJZr9cGhso2_Erz-XL4m_0t--A8iVCIjwE,2639
+cks_runtime/storage/storage.py,sha256=FakKf82T2XmUB9kz4ynwxpUsPy1_5ZUxhB6TLv4RvwY,1675
+cks_runtime/transaction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/transaction/transaction.py,sha256=c-pBm3e97q4E0JSh2EtkAFCde9QlpsKd34s_V5ivbcE,3122
+cks_runtime/transaction/transaction_manager.py,sha256=8Ide59YSma05jtp2TzW83QsBghbU3r_1m8Vm7SPsrS4,2418
+cks_runtime/versioning/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cks_runtime/versioning/version.py,sha256=2tZbVnIYGd_zs7ryw0siiIFCGQ78JP7hyNmyqpaC4Bc,873
+cks_runtime/versioning/version_manager.py,sha256=lvJCZE4JaAYGxAO9hGDwq5Hg_ErwqDEZek4lgZmh4Rw,1870
+cks_runtime-0.1.2.dist-info/licenses/LICENSE,sha256=P9LKfSvJiBAV4S_uJD5AfMgkCh_Ex_zdo4WTy6sMuBg,1066
+cks_runtime-0.1.2.dist-info/METADATA,sha256=aOwN2f9ALK8meOSPDshdY157PWCwCQOEx0MNdy3mPvk,6112
+cks_runtime-0.1.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+cks_runtime-0.1.2.dist-info/top_level.txt,sha256=wuM4ORaU7pDB5QbEXK6uo-ULqIVePdYVUNDL-_ggY4s,12
+cks_runtime-0.1.2.dist-info/RECORD,,

cks_runtime-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cks_runtime-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deus-corp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cks_runtime-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+cks_runtime