☸️ Sovereign OS Kubernetes CRDs & Cluster Topology

🏠 Home | 🎛️ Console | 🤖 Copilot | 📐 Architecture | ⚙️ Subsystems | 🌐 API Reference | 💻 REPL Commands | ☸️ K8s CRDs | 🛡️ Invariants & Rules | 🔄 Bi-Directional Sync

---

1. Documentation Custom Resource Definitions

DocumentationArtifact (documentationartifacts.kontextkube.io)

**Group**: kontextkube.io

**Version**: v1alpha1

**Scope**: Namespaced (apex-cortex)

**Short Names**: docart, da

**Purpose**: Represents an immutable or live-synced documentation page or schema artifact maintained by ops/live_docs and docmesh-operator.

**Example Manifest**:

`yaml

apiVersion: kontextkube.io/v1alpha1

kind: DocumentationArtifact

metadata:

name: sovereign-architecture

namespace: apex-cortex

labels:

app.kubernetes.io/part-of: sovereign-os

docmesh.kontextkube.io/synced: "true"

spec:

title: "Sovereign OS Architecture"

slug: "architecture"

format: "markdown"

sha256: "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

content: |

# Sovereign OS Architecture

...

metadata:

subsystemsCount: 12

routesCount: 22

commandsCount: 45

`

DocMeshRewriteEnvelope (docmeshrewriteenvelopes.kontextkube.io)

**Purpose**: Governs autonomic documentation rewriting proposals when code changes occur, ensuring doc rewrites are audited before being committed back to the repository.

---

2. Apex1 Cluster Topology

The apex-cortex namespace houses the sovereign microservices:

Pod Name	Purpose	Excluded / Ingress Ports
sovereign-os-builder	Continuous compilation & testing environment for Sovereign OS.	Direct workspace mount
docmesh-operator	Reconciles DocumentationArtifact CRDs with live documentation states.	Cluster-internal
valkey-broker	Ultra-fast in-memory SSOT database for context cubes, drift vectors, and live docs.	Port 6379
shadow-solver-daemon	Mathematical validator and Rubik's cube tensor arbitrator.	Port 8082 (NodePort 30882)
gemma-cobrowser	24/7 headless browser bridge for Copilot and CDP automation.	Port 3456 (API), 9222 (CDP)
kontextkube-operator	Core context governor enforcing 5D Context Cube topology.	Cluster-internal