quantsmind 1.0.0__tar.gz

quantsmind-1.0.0/.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.py]
+indent_size = 4
+max_line_length = 100
+
+[*.{yml,yaml,json,toml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

quantsmind-1.0.0/.gitattributes

@@ -0,0 +1,18 @@
+# Normalize line endings
+* text=auto eol=lf
+
+*.py text diff=python
+*.md text
+*.toml text
+*.yml text
+*.yaml text
+*.json text
+
+# Binary assets
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.pdf binary
+
+# Mark generated/vendored paths as not-user-editable in diffs (none yet)

quantsmind-1.0.0/.gitignore

@@ -0,0 +1,63 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Separate Tauri/Studio development project (not part of the SDK)
+quantsmind-db/
+
+# Testing / coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment / secrets
+.env
+.env.*
+*.local
+
+# Build artifacts
+*.log
+.cache/
+site/
+
+# Dependency / build trees (never track)
+node_modules/
+target/
+dist-newstyle/
+
+# Analysis scratch output (local lint/type runs)
+mypy_output.txt
+mypy_after*.txt
+ruff_output.txt
+ruff_after.txt
+ruff_after*.txt
+ruff_current.txt
+ruff_final.txt
+ruff_fix*.txt
+ruff_new.txt
+test_unittmp.txt

quantsmind-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,27 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.11.2
+    hooks:
+      - id: mypy
+        additional_dependencies: []
+        args: [--strict]
+        files: ^src/
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: mixed-line-ending
+        args: [--fix=lf]

quantsmind-1.0.0/ARCHITECTURE_DIAGRAM.md

@@ -0,0 +1,191 @@
+# QuantsMind SDK Architecture Diagram
+
+## Overview
+
+QuantsMind SDK is a universal scientific computing framework built on a single first-principle model: **A System is composed of Entities**. The current version (R0.1.0) is architecture-only, defining interfaces without implementations.
+
+## High-Level Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                         QuantsMind SDK (R0.1.0)                            │
+│                    Architecture-Only Foundation Layer                       │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Package Dependency Layers
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 10: Cross-Cutting                           │
+│  visualization │ datasets │ plugins │ telemetry                            │
+│  (depend on lower layers only, never on domain packages)                    │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 9: Domain Packages                          │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
+│  │ quantum  │  │ physics  │  │ chemistry│  │ biology  │  │ astronomy│      │
+│  │ (+runtime│  │          │  │   →      │  │   →      │  │   →      │      │
+│  │  compiler│  │          │  │ physics) │  │ chemistry│  │ physics) │      │
+│  │  providers│ │          │  │          │  │          │  │          │      │
+│  └──────────┘  └──────────┘  └──────────┘  └──────────┘  └──────────┘      │
+│  ┌──────────┐  ┌──────────┐                                                   │
+│  │cosmology │  │   ai     │                                                   │
+│  │   →      │  │          │                                                   │
+│  │astronomy │  │          │                                                   │
+│  │   physics│  │          │                                                   │
+│  └──────────┘  └──────────┘                                                   │
+│  ┌──────────┐                                                              │
+│  │ finance  │                                                              │
+│  │   →      │                                                              │
+│  │ math,    │                                                              │
+│  │optimiz., │                                                              │
+│  │   ai     │                                                              │
+│  └──────────┘                                                              │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 8: Simulation                               │
+│  simulation (depends on foundation, core, math)                              │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 7: Optimization                              │
+│  optimization (depends on math, foundation, exceptions)                       │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                    LAYER 6: Execution Model                                  │
+│  runtime │ compiler │ providers                                              │
+│  (depend on core, foundation, exceptions)                                    │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 5: Mathematics                               │
+│  math (linear algebra, tensors, geometry, probability, statistics,           │
+│       calculus, optimization primitives, graph theory, complex numbers,      │
+│       numerical methods)                                                     │
+│  (depends on foundation, exceptions)                                         │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 4: Core                                      │
+│  core (shared abstractions: registries, contexts, base containers)           │
+│  (depends on foundation, exceptions)                                        │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           LAYER 3: Foundation                                │
+│  foundation (universal ontology: Entity, System, State, Interaction, ...)   │
+│  (depends only on exceptions)                                                │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                    LAYER 2: Infrastructure                                  │
+│  config │ io │ security                                                      │
+│  (depend only on layer 1)                                                    │
+└──────────────────────────────────────────────────────────────────────────────┘
+                                        │
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                    LAYER 1: Base Utilities                                   │
+│  exceptions │ utils │ logging                                               │
+│  (no internal dependencies)                                                 │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Foundation Ontology (The Core Model)
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                        Foundation Ontology                                   │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ Entity (atomic unit)                                                   │ │
+│  │  ├── Identity (unique identifier)                                      │ │
+│  │  ├── Property (named characteristics)                                  │ │
+│  │  ├── Attribute (typed values)                                          │ │
+│  │  ├── State (current condition)                                         │ │
+│  │  ├── Behaviour (actions/responses)                                     │ │
+│  │  ├── Relationship (connections to other entities)                     │ │
+│  │  ├── Constraint (rules/limitations)                                    │ │
+│  │  └── Lifecycle (creation/evolution/destruction)                        │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ System (collection of entities)                                        │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ Interaction (how entities affect each other)                          │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ Space & Time (context for evolution)                                    │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ Event (discrete occurrences)                                           │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ Observation (capturing evolution)                                       │ │
+│  │  └── Knowledge (derived from observations)                              │ │
+│  │      └── Prediction (anticipating future states)                        │ │
+│  │          └── Decision (choosing actions)                                │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+│  ┌────────────────────────────────────────────────────────────────────────┐ │
+│  │ Transformation (state changes)                                          │ │
+│  └────────────────────────────────────────────────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Key Design Principles
+
+1. **Composition over Inheritance**: Systems are composed of Entities and Relationships rather than deep class hierarchies
+
+2. **Vendor Independence**: `providers` package isolates all hardware/cloud vendor specifics behind stable contracts
+
+3. **Interfaces before Implementations**: R0.1.0 ships only abstract contracts; concrete numerical/algorithmic implementations are future releases
+
+4. **Universal Ontology**: All domain packages (quantum, physics, chemistry, biology, astronomy, cosmology, finance, AI) specialize the same foundation ontology instead of reinventing their own
+
+## Domain Package Specialization
+
+Each domain package specializes the foundation ontology:
+
+- **quantum**: Thin integration layer over MicroQuantum (QuantumProgram, QuantumExperiment, QuantumResult, algorithm delegation); engine concepts (Qubit, Circuit, Gate, Operator, Hamiltonian, Measurement, Noise, Statevector) are owned by MicroQuantum
+- **physics**: Physical systems domain model
+- **chemistry**: Molecular/chemical systems domain model (depends on physics)
+- **biology**: Biological systems domain model (depends on chemistry)
+- **astronomy**: Astronomical systems domain model (depends on physics)
+- **cosmology**: Universe-scale structure/evolution domain model (depends on astronomy, physics)
+- **finance**: Quantitative finance domain model (depends on math, optimization, ai)
+- **ai**: AI/ML domain model
+
+## Repository Structure
+
+```
+quantsmind-sdk/
+├── src/quantsmind/        # 23 installable packages (architecture-only)
+├── docs/                  # Architecture, developer & contribution docs
+├── architecture/          # Architecture Decision Records (ADRs)
+├── research/              # Exploratory notes (not public API)
+├── examples/              # Usage examples (shape-only in R0.1.0)
+├── tutorials/             # Onboarding material
+├── tests/                 # Unit / integration / regression / performance
+├── benchmarks/            # Long-running performance tracking
+├── scripts/               # Developer & CI utility scripts
+├── configs/               # Default non-secret configuration
+├── assets/                # Docs/branding static assets
+├── tools/                 # Internal dev tooling (not shipped)
+└── .github/               # CI workflows, issue/PR templates
+```
+
+## Current Status: R0.1.0
+
+- **No scientific algorithms**: Contains no quantum, AI, optimization, or simulation algorithms
+- **Architecture-only**: Defines complete package layout, public interface contracts, and documentation standards
+- **All abstract**: Every symbol is an abstract interface (ABC with NotImplementedError)
+- **Future implementations**: Concrete numerical/algorithmic implementations planned for future releases (see ROADMAP.md)
+
+## Dependency Rules (Hard Constraints)
+
+- No circular imports between packages, ever
+- Domain packages never import each other except via explicit documented arrows
+- Only `providers` may reference vendor-specific SDKs, and only behind optional extras in pyproject.toml
+- Lower layers never depend on higher layers

quantsmind-1.0.0/CHANGELOG.md

@@ -0,0 +1,117 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.0.0] - 2026-09-13
+
+### Added
+- **QuantsMind Quantum 1.0.0 — Stable release** (release hardening / QMQ-12):
+  the first stable release of the domain-oriented quantum intelligence SDK.
+- Public API freeze for 1.0.0: `api_manifest.json` machine-readable baseline
+  (117 public modules, 669 public symbols) generated by
+  `scripts/generate_api_manifest.py` and verified by the release tests.
+- Release-hardening tests (`tests/unit/quantum/test_release_qmq12.py`):
+  single authoritative version, package metadata, `__all__` integrity across
+  every public module, API-manifest equality against the live import surface,
+  representative serialization round-trips, canonical documented finance
+  values, honest blocked-MicroQuantum behavior, and stable-release README
+  language.
+- Installation & quick-start documentation in the quantum README
+  (`pip install quantsmind`, optional `pip install "quantsmind[quantum]"`).
+
+### Changed
+- Version raised to **1.0.0** (single authoritative source: `pyproject.toml`
+  and `quantsmind.__version__`); classifier `Development Status :: 5 -
+  Production/Stable`.
+- Optional MicroQuantum extra pinned to the tested engine series
+  (`microquantum>=0.4.0,<0.5.0`), matching the published PyPI releases.
+- CI lint/type-check scopes aligned with the release source tree
+  (`src/quantsmind/quantum`).
+- Quantum README status is now "QuantsMind Quantum 1.0.0 — Stable"; the
+  R0.1.0 architecture-only status in the root README is historical.
+
+### Fixed
+- Corrupted non-ASCII byte sequence in the `pyproject.toml` description that
+  broke strict TOML parsing.
+- Packaging hardening: lean sdist (excludes local-only/dev trees such as
+  `venv`, `dist`, `quantsmind-db`, scratch capture files).
+
+### Notes
+- The full QMQ-01..QMQ-11 capability history is preserved below and in
+  `src/quantsmind/quantum/README.md`.
+
+## [R0.2.0] - 2026-07-29
+
+### Added
+- Full Foundation Package specification at
+  `docs/foundation-specification/`: module descriptions for all 26
+  `foundation` modules; complete class specifications (attributes,
+  properties, behaviors, method contracts, private helpers, lifecycle,
+  events, exceptions, interfaces, validation, serialization, thread
+  safety, logging, metrics, tests, documentation) for `Entity`,
+  `System`, `State`, `Interaction`, and the 13 supporting concept
+  classes.
+- Nine new infrastructure module specs: `interfaces.py`,
+  `protocols.py`, `enums.py`, `validators.py`, `serializers.py`,
+  `factories.py`, `exceptions.py`, `constants.py`, `types.py`.
+- SDK-wide `EventType` catalog and `EventBus` contract
+  (`07-events.md`).
+- Full `QuantsMindError` exception hierarchy
+  (`06-exceptions-and-utilities.md`).
+- Cross-cutting validation and serialization strategy
+  (`08-validation-and-serialization-strategy.md`).
+- UML: package, class, sequence, and dependency diagrams in Mermaid
+  (`09-uml.md`).
+- Testing strategy: positive/negative/boundary/validation/
+  serialization/performance scenario catalog per class
+  (`10-testing-strategy.md`).
+- Documentation structure and completeness gate
+  (`11-documentation-structure.md`).
+- Foundation-package-specific implementation roadmap
+  (`12-roadmap.md`), sequencing R0.2.1–R0.2.7 and the first domain
+  consumer (`quantum`) at R0.3.0.
+- ADR 0002: Foundation Package Full Specification.
+
+### Notes
+Still specification-only — **no implementation code**. This release
+supersedes the bare `ABC` skeletons shipped in R0.1.0 with an
+implementable design suitable for another engineer or AI to build
+from directly.
+
+## [R0.1.0] - 2026-07-28
+
+### Added
+- Initial repository foundation: full directory structure per
+  `docs/architecture-overview.md`.
+- 26 top-level packages under `src/quantsmind/` with `__init__.py` and
+  `README.md` (Purpose / Responsibility / Dependencies / Future
+  Interfaces / Status / Testing).
+- Foundation ontology interfaces: `Entity`, `System`, `State`,
+  `Interaction`, `Identity`, `Property`, `Attribute`, `Relationship`,
+  `Behaviour`, `Constraint`, `Space`, `Time`, `Event`, `Observation`,
+  `Knowledge`, `Transformation`, `Lifecycle`.
+- Quantum domain interface skeletons: `Qubit`, `Circuit`, `Register`,
+  `Gate`, `Operator`, `Statevector`, `Hamiltonian`, `Measurement`,
+  `Noise`, `Provider`, `Backend`, `Runtime`, `Transpiler`.
+- Math sub-package skeletons: linear algebra, tensor algebra,
+  geometry, probability, statistics, calculus, optimization, graph
+  theory, complex numbers, numerical methods.
+- Documentation set: architecture overview, developer guide,
+  contribution guide, coding/naming standards, versioning policy,
+  release strategy, package dependency rules, API design principles,
+  documentation standards.
+- First Architecture Decision Record (ADR 0001: Foundation Ontology).
+- Testing scaffolding: `tests/{unit,integration,regression,performance}`
+  mirroring the source package tree.
+- DevOps scaffolding: GitHub Actions CI, Ruff, MyPy, pytest/coverage
+  config, pre-commit hooks.
+- Governance docs: `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`,
+  `SECURITY.md`, `LICENSE` (Apache 2.0).
+
+### Notes
+This is an **architecture-only** release. No scientific, quantum, AI,
+optimization, or simulation algorithms are implemented. See
+`ROADMAP.md` for the implementation sequence.

quantsmind-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,54 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation
+in the QuantsMind SDK community a harassment-free experience for
+everyone, regardless of age, body size, visible or invisible
+disability, ethnicity, sex characteristics, gender identity and
+expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Focusing on what is best for the community and the project
+
+Examples of unacceptable behavior:
+- The use of sexualized language or imagery, and sexual attention of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or
+  political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing
+standards of acceptable behavior and will take appropriate corrective
+action in response to any behavior deemed inappropriate, threatening,
+offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all project spaces, and also
+applies when an individual is officially representing the project in
+public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported to the project maintainers through the reporting
+channel listed in the project's repository page. All complaints will
+be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1.
+
+[homepage]: https://www.contributor-covenant.org

quantsmind-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to QuantsMind SDK
+
+Thank you for considering a contribution. QuantsMind is designed for
+decades of evolution, so we favor careful, well-justified changes over
+speed.
+
+## Before you start
+
+1. Read `docs/architecture-overview.md` and
+   `docs/package-dependency-rules.md`.
+2. For anything touching architecture (new packages, new cross-package
+   dependencies, new public interfaces), open an issue first and, if
+   accepted, add an ADR under `architecture/decisions/`.
+3. Check `ROADMAP.md` — implementation work should map to a roadmap
+   item; if it doesn't, discuss it in an issue first.
+
+## Engineering principles (non-negotiable)
+
+1. Mathematics before implementation.
+2. Architecture before code.
+3. Interfaces before implementations.
+4. Composition before inheritance.
+5. Simplicity before optimization.
+6. Extensibility before specialization.
+7. Documentation before release.
+8. Testing before optimization.
+9. Vendor independence.
+10. Scientific correctness.
+11. Clean public APIs.
+12. Minimal coupling / high cohesion.
+13. Backward compatibility whenever possible.
+
+## Workflow
+
+1. Fork and branch: `feature/<short-desc>`, `fix/<short-desc>`, or
+   `docs/<short-desc>`.
+2. Make one logical change per PR.
+3. Run locally:
+   ```bash
+   ruff check .
+   mypy src
+   pytest tests/unit
+   ```
+4. Update `CHANGELOG.md` under `[Unreleased]`.
+5. Open a PR describing *why*, not just *what*.
+
+## New package checklist
+
+- [ ] `src/quantsmind/<name>/__init__.py`
+- [ ] `src/quantsmind/<name>/README.md` (Purpose / Responsibility /
+      Dependencies / Future Interfaces / Status / Testing)
+- [ ] Entry added to `docs/package-dependency-rules.md`
+- [ ] Mirrored `tests/unit/<name>`, `tests/integration/<name>`
+- [ ] No new circular dependencies
+
+## Code of Conduct
+
+By participating, you agree to abide by `CODE_OF_CONDUCT.md`.
+
+## Reporting security issues
+
+Do not open a public issue. See `SECURITY.md`.

quantsmind-1.0.0/LICENSE

@@ -0,0 +1,99 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        https://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.
+
+      "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.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice included in or attached to 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.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, 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; 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.
+
+   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.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or agreed
+      to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied.
+
+   8. Limitation of Liability. In no event and under no legal theory
+      shall any Contributor be liable to You for damages arising as a
+      result of this License or out of the use or inability to use the
+      Work.
+
+   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 consistent with this License.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 QuantsMind SDK Contributors
+
+   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
+
+       https://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.