soma-wisdom 0.3.0b1__tar.gz

soma_wisdom-0.3.0b1/.github/workflows/ci.yml

@@ -0,0 +1,74 @@
+name: SOMA CI
+
+on:
+  push:
+    branches: [main, develop]
+    paths-ignore:
+      - '*.md'
+      - 'docs/**'
+  pull_request:
+    branches: [main]
+    paths-ignore:
+      - '*.md'
+      - 'docs/**'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install system deps
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq build-essential libgomp1
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install numpy  # faiss-cpu 需要预装 numpy
+          pip install -e ".[dev,alpha]"
+
+      - name: Debug installed packages
+        run: |
+          pip list 2>/dev/null | grep -iE "litellm|fastembed|faiss|chroma|pytest"
+
+      - name: Check import
+        run: |
+          python -c "import soma; print('soma import OK')"
+
+      - name: Run tests
+        run: |
+          pytest -v --tb=long --timeout=60 -ra
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Verify wheel
+        run: |
+          pip install twine
+          twine check dist/*

soma_wisdom-0.3.0b1/.gitignore

@@ -0,0 +1,75 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+eggs/
+*.egg
+.eggs/
+
+# Virtual environments
+venv/
+.venv/
+env/
+.env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+*.cover
+
+# Type checking
+.mypy_cache/
+
+# ChromaDB persistence (user data)
+chroma_data/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# SOMA specific
+*.log
+soma_runs/
+soma_data/
+dashboard_data/
+
+# LLM config (contains API keys — NEVER commit)
+dash/llm_config.json
+
+# Integration guide example data directories
+soma_test_data/
+soma_langchain_data/
+
+# Frontend
+dash/frontend/dist/
+dash/frontend/node_modules/
+
+# Jupyter
+.ipynb_checkpoints/
+*.ipynb
+
+# Ruff
+.ruff_cache/
+
+# Benchmarks
+benchmark_results/
+
+# Screenshots (source materials)
+ysimages/

soma_wisdom-0.3.0b1/CHANGELOG.md

@@ -0,0 +1,126 @@
+# Changelog
+
+All notable changes to SOMA will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.3.0b1] — Unreleased
+
+### Added
+- **MMR diversity re-ranking**: ActivationHub now uses Maximal Marginal Relevance to balance relevance with content/source diversity, preventing near-duplicate memories from dominating results
+- **Hub pluggable architecture**: `ActivationHub` decomposed into 3-stage pipeline — `MemoryRetriever` (recall), `RelevanceScorer` (scoring), `MMRRanker` (re-ranking) — all replaceable via constructor injection or `pyproject.toml` entry points
+- **Entry points plugin system**: `[project.entry-points."soma.plugins"]` — external packages can register custom retriever/scorer/ranker implementations
+- **Frontend route lazy loading**: Vue Router dynamic imports reduce initial JS payload by 75% (756KB → 188KB)
+
+### Changed
+- `soma/hub.py` → facade re-export; implementation moved to `soma/hub/` sub-package
+- `hub.activate()` now applies threshold AFTER MMR re-ranking for wider candidate pool
+- Hard dedup at >88% Jaccard similarity during MMR selection
+
+### Fixed
+- Version strings unified to "0.3.0b1" across all modules
+- `benchmarksRun()` API function added to frontend
+
+---
+
+## [0.2.0-alpha] — 2026-04-26
+
+### Added
+- **Semantic Search**: ONNX-powered vector embeddings (fastembed) with FAISS ANN search, replacing pure keyword matching
+- **Bidirectional Activation**: Weighted Reciprocal Rank Fusion (semantic ×2 + keyword ×1) for memory retrieval
+- **WisdomEngine v2**: jieba Chinese tokenization with stopword filtering and expanded trigger sets
+- **MetaEvolver**: Full evolution loop — auto-adjust law weights every 10 sessions (±2%), skill solidification
+- **Memory Dedup**: SHA256 content-hash based deduplication for episodic memories
+- **Dashboard**: Vue 3 + Vite frontend with 6 views (Chat, Framework, Memory, Analytics, Benchmark, Settings)
+- **REST API**: FastAPI server with SSE streaming, API key auth, multi-provider LLM management
+- **3D Benchmark Engine**: Memory / Wisdom / Evolution dimensions with competitor comparison data
+- **AnalyticsStore**: SQLite-based session tracking with full context recording
+- **LangChain Tool**: `create_soma_tool()` for LangChain agent integration
+- **CLI Quickstart**: `python -m soma` for one-command verification
+- **CI/CD**: GitHub Actions pipeline (ruff + mypy + pytest + build + benchmark) on Python 3.10/3.11/3.12
+
+### Changed
+- Vector store: ChromaDB → SQLite + FAISS (zero-dependency deployment)
+- Embedding: OpenAI API → ONNX fastembed (CPU inference, offline capable)
+- Keyword engine: simple split → jieba + stopword + punctuation filtering
+- Wisdom law triggers expanded (5 → 12 items per law on average)
+
+### Fixed
+- Memory recall threshold tuning for better precision/recall balance
+- Edge case: empty memory store graceful degradation
+- Dedup race condition on concurrent inserts
+
+---
+
+## [0.1.0] — 2025-05
+
+### Added
+- **WisdomEngine**: Hardcoded 5-law wisdom framework with keyword trigger matching
+- **MemoryCore**: ChromaDB episodic storage + NetworkX semantic graph
+- **ActivationHub**: Keyword-match memory recall with simple relevance sorting
+- **SOMA_Agent**: End-to-end `respond()` pipeline (decompose → recall → template synthesis)
+- **Unit tests**: Core module test coverage
+- **wisdom_laws.yaml**: Initial framework configuration
+
+---
+
+## 变更日志
+
+格式基于 [Keep a Changelog](https://keepachangelogen/zh-CN/1.0.0/)。
+
+### [0.3.0b1] — Unreleased
+
+#### 新增
+- **MMR 多样性重排**: ActivationHub 使用最大边界相关性算法平衡关联度与内容/来源多样性，避免高度重复记忆占据全部结果
+- **Hub 可插拔架构**: `ActivationHub` 拆分为三段式管道 — `MemoryRetriever`（多路召回）、`RelevanceScorer`（相关性打分）、`MMRRanker`（多样性重排）— 均可通过构造器注入或 `pyproject.toml` entry points 替换
+- **Entry points 插件体系**: `[project.entry-points."soma.plugins"]` — 外部包可注册自定义 retriever/scorer/ranker 实现
+- **前端路由懒加载**: Vue Router 动态 import 将首屏 JS 体积压缩 75%（756KB → 188KB）
+
+#### 变更
+- `soma/hub.py` → 门面 re-export；实现迁移至 `soma/hub/` 子包
+- `hub.activate()` 阈值过滤移至 MMR 重排之后，扩大候选池
+- MMR 选择阶段 >88% Jaccard 相似度硬去重
+
+#### 修复
+- 全模块版本字符串统一为 "0.3.0b1"
+- 前端补全 `benchmarksRun()` API 函数
+
+### [0.2.0-alpha] — 2026-04-26
+
+#### 新增
+- **语义搜索**: ONNX 向量嵌入 (fastembed) + FAISS 近邻搜索，替代纯关键词匹配
+- **双向激活**: 加权倒数排序融合（语义×2 + 关键词×1）记忆检索
+- **WisdomEngine v2**: jieba 中文分词 + 停用词过滤 + 扩展触发词集
+- **MetaEvolver**: 完整进化闭环 — 每10次会话自动调权(±2%)、技能固化
+- **记忆去重**: 基于 SHA256 内容哈希的情节记忆去重
+- **Dashboard**: Vue 3 + Vite 前端（6 个视图）
+- **REST API**: FastAPI 服务 + SSE 流式 + API Key 认证 + 多模型管理
+- **3D 基准引擎**: 记忆/智慧/进化三维评测 + 竞品对比数据
+- **AnalyticsStore**: SQLite 会话追踪与完整上下文记录
+- **LangChain 工具**: `create_soma_tool()` 集成
+- **CLI 快速入口**: `python -m soma` 一键验证
+- **CI/CD**: GitHub Actions (ruff + mypy + pytest + build + benchmark)，支持 Python 3.10/3.11/3.12
+
+#### 变更
+- 向量存储: ChromaDB → SQLite + FAISS
+- 嵌入模型: OpenAI API → ONNX fastembed
+- 关键词引擎: 简单分割 → jieba + 停用词 + 标点过滤
+- 规律触发词扩充（平均 5 → 12 个）
+
+#### 修复
+- 记忆召回阈值微调，提升精确率/召回率平衡
+- 空记忆库的优雅降级
+- 并发写入的去重竞态
+
+### [0.1.0] — 2025-05
+
+#### 新增
+- WisdomEngine: 5条硬编码规律 + 关键词触发匹配
+- MemoryCore: ChromaDB 情节存储 + NetworkX 语义图谱
+- ActivationHub: 关键词匹配召回 + 简单关联排序
+- SOMA_Agent: 端到端 respond() 管道（拆解→召回→模板合成）
+- 单元测试覆盖核心模块
+- wisdom_laws.yaml 初始框架配置

soma_wisdom-0.3.0b1/CONTRIBUTING.md

@@ -0,0 +1,178 @@
+# Contributing to SOMA
+
+Thank you for your interest in contributing. SOMA is an open-source project under Apache 2.0 license, and we welcome contributions of all kinds.
+
+## Code of Conduct
+
+Be respectful. Be constructive. Assume good intent.
+
+## How to Contribute
+
+### Report Bugs
+
+Open a GitHub Issue with:
+- SOMA version (`python -c "import soma; print(soma.__version__)"`)
+- Python version (`python --version`)
+- Minimal reproduction steps
+- Expected vs actual behavior
+
+### Suggest Features
+
+Open a GitHub Issue with:
+- Problem statement (what pain does this solve?)
+- Proposed solution sketch
+- Why it belongs in SOMA core vs an external plugin
+
+### Submit Code
+
+1. **Fork** the repository
+2. **Create a branch**: `feature/your-feature` or `fix/your-bug`
+3. **Write code** following the conventions below
+4. **Add tests** covering your changes
+5. **Run the full suite**: `pytest -v --cov=soma --cov-report=term`
+6. **Run linting**: `ruff check soma/ tests/`
+7. **Run type checks**: `mypy soma/ --ignore-missing-imports`
+8. **Commit** using conventional commit format (see below)
+9. **Open a Pull Request** against the `main` branch
+
+## Development Setup
+
+```bash
+git clone https://github.com/soma-project/soma-core.git
+cd soma-core
+pip install -e ".[dev]"
+```
+
+## Code Conventions
+
+### Style
+- Follow PEP 8, enforced by Ruff
+- Line length: 100 characters
+- Use type hints for public APIs
+
+### Tests
+- Framework: pytest
+- Coverage target: > 80% for new code
+- Pattern: table-driven tests preferred
+- Assertions: plain `assert` statements
+
+### Docstrings
+- Public modules, classes, and functions must have docstrings
+- Use Google-style docstring format
+
+### Commit Format
+
+```
+<type>(<scope>): <description>
+```
+
+Types: `feat`, `fix`, `docs`, `test`, `refactor`, `chore`
+
+Examples:
+- `feat(engine): add jieba Chinese tokenization`
+- `fix(memory): resolve dedup race condition`
+- `docs(api): add SOMA.respond examples`
+
+## Project Structure
+
+```
+soma/       # Core library — strict API stability
+dash/       # Dashboard + REST server — may change
+tests/      # All tests
+docs/       # Documentation
+examples/   # Integration examples
+scripts/    # Benchmarks and utilities
+```
+
+## Pull Request Process
+
+1. PR description must include: what, why, how tested
+2. CI must pass (ruff + mypy + pytest + build)
+3. At least one maintainer review required
+4. PRs that change public API must update docs and CHANGELOG.md
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the Apache License 2.0.
+
+---
+
+# 贡献指南
+
+感谢你对 SOMA 的关注。SOMA 是 Apache 2.0 许可下的开源项目，欢迎各种形式的贡献。
+
+## 行为准则
+
+尊重他人。建设性讨论。假定善意。
+
+## 贡献方式
+
+### 报告 Bug
+
+提交 GitHub Issue，包含：
+- SOMA 版本
+- Python 版本
+- 最小复现步骤
+- 预期行为 vs 实际行为
+
+### 建议功能
+
+提交 GitHub Issue，包含：
+- 问题描述（解决什么痛点？）
+- 方案草图
+- 为什么应该放在 SOMA 核心而非外部插件
+
+### 提交代码
+
+1. **Fork** 仓库
+2. **创建分支**: `feature/功能名` 或 `fix/问题名`
+3. **编写代码**，遵循以下规范
+4. **添加测试**覆盖你的改动
+5. **运行完整套件**: `pytest -v --cov=soma --cov-report=term`
+6. **运行代码检查**: `ruff check soma/ tests/`
+7. **运行类型检查**: `mypy soma/ --ignore-missing-imports`
+8. **提交**使用约定式提交格式
+9. **发起 Pull Request** 目标分支 `main`
+
+## 开发环境配置
+
+```bash
+git clone https://github.com/soma-project/soma-core.git
+cd soma-core
+pip install -e ".[dev]"
+```
+
+## 代码规范
+
+### 风格
+- 遵循 PEP 8，Ruff 强制执行
+- 行长度: 100 字符
+- 公开 API 使用类型标注
+
+### 测试
+- 框架: pytest
+- 覆盖率目标: 新代码 > 80%
+- 模式: 优先使用 table-driven tests
+
+### 文档字符串
+- 公开模块、类、函数必须有 docstring
+- 使用 Google 风格 docstring 格式
+
+### 提交格式
+
+```
+<type>(<scope>): <description>
+```
+
+类型: `feat`、`fix`、`docs`、`test`、`refactor`、`chore`
+
+## PR 流程
+
+1. PR 描述必须包含: 做了什么、为什么、如何测试
+2. CI 必须通过 (ruff + mypy + pytest + build)
+3. 至少一位维护者审核
+4. 修改公开 API 的 PR 必须同步更新文档和 CHANGELOG.md
+
+## 许可
+
+贡献即表示你同意将贡献以 Apache License 2.0 许可发布。

soma_wisdom-0.3.0b1/INTRO.md

@@ -0,0 +1,15 @@
+# SOMA: Wisdom over Memory
+
+Most AI memory systems treat memory as passive storage — store everything, retrieve by similarity, hope it's relevant. This is the "high-IQ archive clerk" model: impressive recall, no framework for understanding what matters and why.
+
+SOMA inverts this paradigm. Instead of asking "what stored knowledge is similar to this query?", it asks a deeper question: **"What thinking patterns does this problem activate, and what memories become relevant under those patterns?"**
+
+At its core sits an explicit wisdom framework — seven thinking laws drawn from cognitive science and strategic reasoning: First Principles (regress to fundamentals), Systems Thinking (map interconnections), Contradiction Analysis (surface hidden tensions), Pareto Principle (find the critical few), Inversion (reason backwards), Analogical Reasoning (bridge domains), and Evolutionary Lens (track what adapts). Each law carries weighted keyword triggers and defined inter-relationships. When a problem arrives, SOMA decomposes it through these lenses, identifying which dimensions of thought apply and why — then assembles a structured prompt that guides the LLM rather than merely feeding it context.
+
+This decomposition drives **bidirectional activation**. Rather than one-directional similarity search, SOMA computes the associative potential between each analysis focus and each stored memory — producing a ranked set of truly relevant knowledge, not just keyword-matched text. The framework acts as the index; memory supplies the substance.
+
+The four-stage pipeline — Decompose, Activate, Synthesize, Evolve — runs with every query. After synthesis, SOMA reflects on which memories proved useful and adjusts law weights over time. Laws that consistently generate insight grow stronger; underused ones naturally fade. A law discovery module can even propose new thinking patterns from high-cohesion memory clusters, subject to human approval.
+
+Built as a lightweight Python library with zero mandatory dependencies beyond the standard library, SOMA integrates in five minutes via pip. It ships with a REST API for remote access, a Vue.js dashboard for visual management, native LangChain tooling, and dual memory stores — episodic for experiences and semantic for knowledge triples — with optional vector search for cross-lingual semantic recall. The architecture is fully mockable: every LLM-dependent component accepts an interface, making it trivial to test without API calls. All 139 tests pass at 97% coverage. Zero API keys in the repository.
+
+**Not "make AI remember more." Make AI understand deeper.**

soma_wisdom-0.3.0b1/LICENSE

@@ -0,0 +1,201 @@
+                                 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
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 SOMA Project Team
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.