vikela 4.6.0__tar.gz

vikela-4.6.0/.gitignore

@@ -0,0 +1,48 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing & Linting
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+.mypy_cache/
+.ruff_cache/
+.pylint.d/
+
+# IDE & OS
+.DS_Store
+.idea/
+.vscode/

vikela-4.6.0/LICENSE

@@ -0,0 +1,176 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

vikela-4.6.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.5
+Name: vikela
+Version: 4.6.0
+Summary: Python mutation guardrails for JsonPit
+Project-URL: Repository, https://github.com/Burkhardt/vikela
+Project-URL: Documentation, https://github.com/Burkhardt/vikela/blob/main/docs/rules.md
+Author: Dr. Rainer Burkhardt
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.12
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: ipython>=8; extra == 'dev'
+Requires-Dist: pylint<5,>=3.3; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: notebook
+Requires-Dist: ipython>=8; extra == 'notebook'
+Provides-Extra: pylint
+Requires-Dist: pylint<5,>=3.3; extra == 'pylint'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Burkhardt/vikela/main/assets/vikela-logo.svg" width="160" height="160" alt="Vikela Logo" />
+</p>
+
+<h1 align="center">Vikela 🛡️</h1>
+
+<p align="center">
+  <strong>Python mutation guardrails and AST linter for JsonPit.</strong><br>
+  <em>The defensive shield protecting distributed state from concurrent cloud replica stomps.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/vikela/"><img src="https://img.shields.io/badge/PyPI-vikela-D4AF37?style=flat-square&logo=pypi" alt="PyPI"></a>
+  <a href="https://github.com/Burkhardt/RAIkeep/blob/main/doc/CR077_AIA_and_AfricaStage_to_RAIkeep_Vikela_and_JsonPit_Mutation_Guardrails.md"><img src="https://img.shields.io/badge/CR-CR077-blue?style=flat-square" alt="Specification"></a>
+  <a href="docs/VIKELA_VISUAL_IDENTITY_AND_ICON_SPEC.md"><img src="https://img.shields.io/badge/Identity-Modernist%20Ihawu-AA8214?style=flat-square" alt="Design Spec"></a>
+</p>
+
+---
+
+## Overview
+
+**Vikela** (*isiZulu: "to protect / shield"*) provides static analysis and mutation guardrails for `JsonPit` and its surrounding framework across the fleet. It functions both as a standalone CLI (`vikela`) and as a native Pylint checker plugin (`pylint --load-plugins=vikela`).
+
+### The Twin-Shield Doctrine
+* **C# development (.NET):** Checked by `RaiGuard`.
+* **Python development:** Checked by `vikela`; JsonPit itself enforces runtime mutation guards.
+* **The Straightening Action (`--qondisa`):** An official first-class alias for `--fix` (*isiZulu: "to straighten out / rectify"*), reserved for proven safe repairs. Version 4.6.0 provides suggestions and has no approved automatic rewrites.
+
+---
+
+## Core Rules
+
+| Rule ID | Diagnostic Symbol | Description |
+| :--- | :--- | :--- |
+| **`RAI011`** | `vikela-full-snapshot-write` | Prevents full-snapshot read-modify-writes that erase concurrent cloud replica fields. |
+| **`RAI012`** | `vikela-protected-attribute` | Protects immutable lifecycle and schema attributes from unauthorized client modification. |
+
+---
+
+## Terminal & CLI Experience
+
+```bash
+# Standard Scan
+󰞀 vikela .
+
+# Request safe fixes (v4.6.0 reports suggestions and leaves source unchanged)
+vikela src/ --qondisa
+
+# Pure JSON for CI/CD audit pipelines
+vikela src/ --json
+```
+
+---
+
+## IDE & Editor Integration
+
+### VS Code
+Configure in `.vscode/settings.json`:
+```json
+{
+  "pylint.args": [
+    "--load-plugins=vikela"
+  ]
+}
+```
+
+### JupyterLab
+```python
+%load_ext vikela
+
+%%vikela
+# Checks this cell WITHOUT executing it
+```
+
+---
+
+## Visual Identity & Heraldry
+Vikela's emblem is the **Modernist Ihawu**—drawing from the elliptical geometry of the traditional Nguni shield, anchored by the central **Qondisa Axis** (the plumb line that straightens crooked code).
+
+* **Design Specification:** [`docs/VIKELA_VISUAL_IDENTITY_AND_ICON_SPEC.md`](docs/VIKELA_VISUAL_IDENTITY_AND_ICON_SPEC.md)
+* **Master Vector:** [`assets/logo.svg`](assets/logo.svg)
+* **Curator:** Koyo (Chief Marketing & Web Design Assistant)
+
+
+## Version 4.6.0 installation and contracts
+
+Vikela is optional development tooling alongside RAIkeep 4.6.0. Neither jsonpit nor
+jpit depends on it. Until publication, install from this checkout in a development
+virtual environment:
+
+```sh
+python -m pip install -e '.[dev]'
+python -m pytest
+vikela -v
+```
+
+After publication, install `vikela==4.6.0` for the independent CLI, or
+`vikela[pylint]==4.6.0` inside the project's interpreter for editor checks.
+`vikela[notebook]==4.6.0` adds IPython support in the chosen kernel interpreter.
+A global CLI environment alone does not expose the checker in another venv.
+
+Exit codes: **0** clean; **1** findings; **2** syntax/configuration;
+**4** internal/environment failure. Pylint retains its own native exit codes.
+`--json` emits a pure array; operational errors go to stderr. Scans do not import
+or execute the inspected application. `--fix` and `--qondisa` are exact aliases;
+no speculative field-dropping rewrite is available in 4.6.0.
+
+- [Rules, shared project configuration and analysis limits](docs/rules.md)
+- [VS Code, PyCharm and JupyterLab setup](docs/editors.md)
+
+The CLI and plugin share `[tool.vikela]` configuration in pyproject.toml, with a
+`disable` array of logical rule IDs. Checks are bounded and conservative: no
+findings does not prove arbitrary dynamic code safe. Notebook scans follow
+source-cell document order, not previous kernel execution order.
+
+Publication/provisioning is orchestrated by Engenho; production server nodes do
+not receive development lint tooling by default. Native PyCharm inspections are
+milestone 2; milestone 1 supplies an External Tool configuration.

vikela-4.6.0/README.md

@@ -0,0 +1,118 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Burkhardt/vikela/main/assets/vikela-logo.svg" width="160" height="160" alt="Vikela Logo" />
+</p>
+
+<h1 align="center">Vikela 🛡️</h1>
+
+<p align="center">
+  <strong>Python mutation guardrails and AST linter for JsonPit.</strong><br>
+  <em>The defensive shield protecting distributed state from concurrent cloud replica stomps.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/vikela/"><img src="https://img.shields.io/badge/PyPI-vikela-D4AF37?style=flat-square&logo=pypi" alt="PyPI"></a>
+  <a href="https://github.com/Burkhardt/RAIkeep/blob/main/doc/CR077_AIA_and_AfricaStage_to_RAIkeep_Vikela_and_JsonPit_Mutation_Guardrails.md"><img src="https://img.shields.io/badge/CR-CR077-blue?style=flat-square" alt="Specification"></a>
+  <a href="docs/VIKELA_VISUAL_IDENTITY_AND_ICON_SPEC.md"><img src="https://img.shields.io/badge/Identity-Modernist%20Ihawu-AA8214?style=flat-square" alt="Design Spec"></a>
+</p>
+
+---
+
+## Overview
+
+**Vikela** (*isiZulu: "to protect / shield"*) provides static analysis and mutation guardrails for `JsonPit` and its surrounding framework across the fleet. It functions both as a standalone CLI (`vikela`) and as a native Pylint checker plugin (`pylint --load-plugins=vikela`).
+
+### The Twin-Shield Doctrine
+* **C# development (.NET):** Checked by `RaiGuard`.
+* **Python development:** Checked by `vikela`; JsonPit itself enforces runtime mutation guards.
+* **The Straightening Action (`--qondisa`):** An official first-class alias for `--fix` (*isiZulu: "to straighten out / rectify"*), reserved for proven safe repairs. Version 4.6.0 provides suggestions and has no approved automatic rewrites.
+
+---
+
+## Core Rules
+
+| Rule ID | Diagnostic Symbol | Description |
+| :--- | :--- | :--- |
+| **`RAI011`** | `vikela-full-snapshot-write` | Prevents full-snapshot read-modify-writes that erase concurrent cloud replica fields. |
+| **`RAI012`** | `vikela-protected-attribute` | Protects immutable lifecycle and schema attributes from unauthorized client modification. |
+
+---
+
+## Terminal & CLI Experience
+
+```bash
+# Standard Scan
+󰞀 vikela .
+
+# Request safe fixes (v4.6.0 reports suggestions and leaves source unchanged)
+vikela src/ --qondisa
+
+# Pure JSON for CI/CD audit pipelines
+vikela src/ --json
+```
+
+---
+
+## IDE & Editor Integration
+
+### VS Code
+Configure in `.vscode/settings.json`:
+```json
+{
+  "pylint.args": [
+    "--load-plugins=vikela"
+  ]
+}
+```
+
+### JupyterLab
+```python
+%load_ext vikela
+
+%%vikela
+# Checks this cell WITHOUT executing it
+```
+
+---
+
+## Visual Identity & Heraldry
+Vikela's emblem is the **Modernist Ihawu**—drawing from the elliptical geometry of the traditional Nguni shield, anchored by the central **Qondisa Axis** (the plumb line that straightens crooked code).
+
+* **Design Specification:** [`docs/VIKELA_VISUAL_IDENTITY_AND_ICON_SPEC.md`](docs/VIKELA_VISUAL_IDENTITY_AND_ICON_SPEC.md)
+* **Master Vector:** [`assets/logo.svg`](assets/logo.svg)
+* **Curator:** Koyo (Chief Marketing & Web Design Assistant)
+
+
+## Version 4.6.0 installation and contracts
+
+Vikela is optional development tooling alongside RAIkeep 4.6.0. Neither jsonpit nor
+jpit depends on it. Until publication, install from this checkout in a development
+virtual environment:
+
+```sh
+python -m pip install -e '.[dev]'
+python -m pytest
+vikela -v
+```
+
+After publication, install `vikela==4.6.0` for the independent CLI, or
+`vikela[pylint]==4.6.0` inside the project's interpreter for editor checks.
+`vikela[notebook]==4.6.0` adds IPython support in the chosen kernel interpreter.
+A global CLI environment alone does not expose the checker in another venv.
+
+Exit codes: **0** clean; **1** findings; **2** syntax/configuration;
+**4** internal/environment failure. Pylint retains its own native exit codes.
+`--json` emits a pure array; operational errors go to stderr. Scans do not import
+or execute the inspected application. `--fix` and `--qondisa` are exact aliases;
+no speculative field-dropping rewrite is available in 4.6.0.
+
+- [Rules, shared project configuration and analysis limits](docs/rules.md)
+- [VS Code, PyCharm and JupyterLab setup](docs/editors.md)
+
+The CLI and plugin share `[tool.vikela]` configuration in pyproject.toml, with a
+`disable` array of logical rule IDs. Checks are bounded and conservative: no
+findings does not prove arbitrary dynamic code safe. Notebook scans follow
+source-cell document order, not previous kernel execution order.
+
+Publication/provisioning is orchestrated by Engenho; production server nodes do
+not receive development lint tooling by default. Native PyCharm inspections are
+milestone 2; milestone 1 supplies an External Tool configuration.

vikela-4.6.0/assets/logo.svg

@@ -0,0 +1,85 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Background Canvas subtle gradient -->
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#181816"/>
+      <stop offset="100%" stop-color="#23231F"/>
+    </linearGradient>
+
+    <!-- Shield Face Gradients: Modernist African Ochre & Gold -->
+    <linearGradient id="shieldLeft" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#D4AF37"/>
+      <stop offset="100%" stop-color="#AA8214"/>
+    </linearGradient>
+    <linearGradient id="shieldRight" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#E5C158"/>
+      <stop offset="100%" stop-color="#C29B27"/>
+    </linearGradient>
+
+    <!-- Spine / Qondisa Axis Gradient -->
+    <linearGradient id="spineGrad" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#F4F4F0"/>
+      <stop offset="50%" stop-color="#E2E2D8"/>
+      <stop offset="100%" stop-color="#F4F4F0"/>
+    </linearGradient>
+
+    <filter id="subtleGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="8" stdDeviation="16" flood-color="#000000" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+
+  <!-- Background Canvas -->
+  <rect width="512" height="512" rx="104" fill="url(#bgGrad)"/>
+
+  <!-- Outer Architectural Framing Ring (Cascais / Swiss Precision Grid) -->
+  <circle cx="256" cy="256" r="216" fill="none" stroke="#2E2E2A" stroke-width="2" stroke-dasharray="4 8"/>
+  <circle cx="256" cy="256" r="192" fill="none" stroke="#3A3A34" stroke-width="1.5"/>
+
+  <!-- Modernist Nguni Shield (Ihawu) Silhouette -->
+  <!-- The elliptical, pointed African shield contour: slender, sovereign, aerodynamic -->
+  <g filter="url(#subtleGlow)">
+    <!-- Left Wing (Live Object State / RaiGuard counterpart) -->
+    <path d="M 256,64 
+             C 170,120 132,185 132,256 
+             C 132,327 170,392 256,448 
+             L 256,64 Z" 
+          fill="url(#shieldLeft)" />
+
+    <!-- Right Wing (Python Delta Stream / Replicated State) -->
+    <path d="M 256,64 
+             C 342,120 380,185 380,256 
+             C 380,327 342,392 256,448 
+             L 256,64 Z" 
+          fill="url(#shieldRight)" />
+
+    <!-- Imigabelo / Structural Lacing (Geometric Rhythm inspired by Karabo Poppy & Swiss Grids) -->
+    <!-- Abstracted chevron cuts indicating clean delta boundaries -->
+    <!-- Upper Lacing -->
+    <path d="M 188,186 L 240,186 L 232,200 L 196,200 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 324,186 L 272,186 L 280,200 L 316,200 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- Mid-Upper Lacing -->
+    <path d="M 174,226 L 240,226 L 232,240 L 182,240 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 338,226 L 272,226 L 280,240 L 330,240 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- Mid-Lower Lacing -->
+    <path d="M 174,272 L 240,272 L 232,286 L 182,286 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 338,272 L 272,272 L 280,286 L 330,286 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- Lower Lacing -->
+    <path d="M 188,312 L 240,312 L 232,326 L 196,326 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 324,312 L 272,312 L 280,326 L 316,326 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- The Qondisa Axis (The Central Spine / Umgobo) -->
+    <!-- The plumb line that straightens crooked mutations -->
+    <line x1="256" y1="44" x2="256" y2="468" stroke="url(#spineGrad)" stroke-width="6" stroke-linecap="round"/>
+    
+    <!-- Top & Bottom Spine Tips (Staff finials) -->
+    <circle cx="256" cy="44" r="5" fill="#F4F4F0"/>
+    <circle cx="256" cy="468" r="5" fill="#F4F4F0"/>
+
+    <!-- Core Center Sentinel Node (The Immutable Protected Attribute) -->
+    <circle cx="256" cy="256" r="14" fill="#181816"/>
+    <circle cx="256" cy="256" r="7" fill="#F4F4F0"/>
+  </g>
+</svg>

vikela-4.6.0/assets/vikela-logo.svg

@@ -0,0 +1,85 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Background Canvas subtle gradient -->
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#181816"/>
+      <stop offset="100%" stop-color="#23231F"/>
+    </linearGradient>
+
+    <!-- Shield Face Gradients: Modernist African Ochre & Gold -->
+    <linearGradient id="shieldLeft" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#D4AF37"/>
+      <stop offset="100%" stop-color="#AA8214"/>
+    </linearGradient>
+    <linearGradient id="shieldRight" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#E5C158"/>
+      <stop offset="100%" stop-color="#C29B27"/>
+    </linearGradient>
+
+    <!-- Spine / Qondisa Axis Gradient -->
+    <linearGradient id="spineGrad" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#F4F4F0"/>
+      <stop offset="50%" stop-color="#E2E2D8"/>
+      <stop offset="100%" stop-color="#F4F4F0"/>
+    </linearGradient>
+
+    <filter id="subtleGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="8" stdDeviation="16" flood-color="#000000" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+
+  <!-- Background Canvas -->
+  <rect width="512" height="512" rx="104" fill="url(#bgGrad)"/>
+
+  <!-- Outer Architectural Framing Ring (Cascais / Swiss Precision Grid) -->
+  <circle cx="256" cy="256" r="216" fill="none" stroke="#2E2E2A" stroke-width="2" stroke-dasharray="4 8"/>
+  <circle cx="256" cy="256" r="192" fill="none" stroke="#3A3A34" stroke-width="1.5"/>
+
+  <!-- Modernist Nguni Shield (Ihawu) Silhouette -->
+  <!-- The elliptical, pointed African shield contour: slender, sovereign, aerodynamic -->
+  <g filter="url(#subtleGlow)">
+    <!-- Left Wing (Live Object State / RaiGuard counterpart) -->
+    <path d="M 256,64 
+             C 170,120 132,185 132,256 
+             C 132,327 170,392 256,448 
+             L 256,64 Z" 
+          fill="url(#shieldLeft)" />
+
+    <!-- Right Wing (Python Delta Stream / Replicated State) -->
+    <path d="M 256,64 
+             C 342,120 380,185 380,256 
+             C 380,327 342,392 256,448 
+             L 256,64 Z" 
+          fill="url(#shieldRight)" />
+
+    <!-- Imigabelo / Structural Lacing (Geometric Rhythm inspired by Karabo Poppy & Swiss Grids) -->
+    <!-- Abstracted chevron cuts indicating clean delta boundaries -->
+    <!-- Upper Lacing -->
+    <path d="M 188,186 L 240,186 L 232,200 L 196,200 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 324,186 L 272,186 L 280,200 L 316,200 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- Mid-Upper Lacing -->
+    <path d="M 174,226 L 240,226 L 232,240 L 182,240 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 338,226 L 272,226 L 280,240 L 330,240 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- Mid-Lower Lacing -->
+    <path d="M 174,272 L 240,272 L 232,286 L 182,286 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 338,272 L 272,272 L 280,286 L 330,286 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- Lower Lacing -->
+    <path d="M 188,312 L 240,312 L 232,326 L 196,326 Z" fill="#181816" opacity="0.85"/>
+    <path d="M 324,312 L 272,312 L 280,326 L 316,326 Z" fill="#181816" opacity="0.7"/>
+
+    <!-- The Qondisa Axis (The Central Spine / Umgobo) -->
+    <!-- The plumb line that straightens crooked mutations -->
+    <line x1="256" y1="44" x2="256" y2="468" stroke="url(#spineGrad)" stroke-width="6" stroke-linecap="round"/>
+    
+    <!-- Top & Bottom Spine Tips (Staff finials) -->
+    <circle cx="256" cy="44" r="5" fill="#F4F4F0"/>
+    <circle cx="256" cy="468" r="5" fill="#F4F4F0"/>
+
+    <!-- Core Center Sentinel Node (The Immutable Protected Attribute) -->
+    <circle cx="256" cy="256" r="14" fill="#181816"/>
+    <circle cx="256" cy="256" r="7" fill="#F4F4F0"/>
+  </g>
+</svg>