sinmonto 0.1.0rc3__tar.gz

sinmonto-0.1.0rc3/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Rapport de bug
+about: Signaler un comportement incorrect du moteur
+title: "[bug] "
+labels: bug
+---
+
+## Comportement attendu
+
+## Comportement observé
+
+## Reproduire
+
+```python
+# le plus petit exemple possible qui démontre le problème
+```
+
+## Environnement
+- Version de `sinmonto` (`sinmonto.__version__`) :
+- Python (`python3 --version`) :
+- OS / environnement (Termux, Linux, macOS...) :
+
+## Sortie du mini-runner (si pertinent)
+Colle ici la sortie de `python3 -m sinmonto._<module>` ou de la trace
+d'erreur complète.
+
+## Note
+Preview `0.x` : certaines limitations sont **volontaires**, pas des bugs —
+signaux dérivés non traités, `duration_ms` à zéro, etc. Vérifie la section
+« Limitations connues » du [`README.md`](../README.md) avant d'ouvrir.

sinmonto-0.1.0rc3/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Demande de fonctionnalité
+about: Proposer une évolution
+title: "[feat] "
+labels: enhancement
+---
+
+## Le problème ou le besoin
+Quel cas d'usage manque aujourd'hui (fintech, fraude, IoT, e-commerce...) ?
+
+## Solution proposée
+Décris ce que tu aimerais voir, de préférence en termes d'API ou de
+comportement observable.
+
+## Le filtre v1.0
+Est-ce que ça rapproche réellement la v1.0, ou est-ce un besoin qui peut
+attendre ? (Si c'est la seconde réponse, ce n'est pas un problème — ça a
+sa place dans `docs/roadmap-vision.md` plutôt que dans le code immédiat.)
+
+## Alignement avec la constitution
+- [ ] Cette proposition respecte les 10 décisions verrouillées (`docs/constitution-finale.md` §2)
+- [ ] Elle n'ajoute aucune dépendance externe au noyau
+- [ ] Elle reste explicable (traçable dans `ConditionTrace`/`DecisionTrace`)
+
+## Alternatives envisagées

sinmonto-0.1.0rc3/.github/pull_request_template.md

@@ -0,0 +1,25 @@
+## Résumé
+Décris en quelques lignes ce que fait cette PR. `Closes #...` si applicable.
+
+## Type de changement
+- [ ] Correction de bug
+- [ ] Documentation uniquement
+- [ ] Comportement / API (décrire l'impact ci-dessous)
+- [ ] Scaffolding / outillage
+
+## Checklist
+- [ ] J'ai lu `docs/constitution-finale.md` §2 et cette PR ne contredit
+      aucune des 10 décisions verrouillées.
+- [ ] Tests concernés lancés localement (`python3 -m sinmonto._...`, voir
+      `CONTRIBUTING.md`), tous verts.
+- [ ] `python3 examples/end_to_end.py` passe.
+- [ ] Aucun import direct hors `from sinmonto import ...` (surface
+      `sinmonto.__all__` uniquement).
+- [ ] Doc mise à jour si le comportement observable change (`README.md`,
+      `CHANGELOG.md`, ou `docs/`).
+
+## Impact sur la surface publique
+- [ ] Aucun changement de contrat public
+- [ ] Changement de contrat public — expliqué ci-dessous
+
+## Notes pour la revue

sinmonto-0.1.0rc3/.github/workflows/publish.yml

@@ -0,0 +1,33 @@
+name: publish to PyPI
+
+# Déclenchement manuel uniquement (bouton "Run workflow") -- une publication
+# PyPI ne peut pas être annulée une fois faite, mieux vaut un geste explicite
+# à chaque fois plutôt qu'un déclenchement automatique sur un push ou un tag.
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build sdist + wheel
+        run: python -m build
+
+      - name: Check artifacts before upload
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: twine upload dist/*

sinmonto-0.1.0rc3/.github/workflows/tests.yml

@@ -0,0 +1,36 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Module tests
+        run: |
+          python3 -m sinmonto._exceptions
+          python3 -m sinmonto._core
+          python3 -m sinmonto._trace
+          python3 -m sinmonto._testing
+          python3 -m sinmonto._context
+          python3 -m sinmonto._dsl
+          python3 -m sinmonto._engine
+
+      - name: End-to-end example
+        run: python3 examples/end_to_end.py

sinmonto-0.1.0rc3/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.DS_Store
+*.swp
+.vscode/
+.idea/

sinmonto-0.1.0rc3/AGENTS.md

@@ -0,0 +1,50 @@
+# AGENTS.md
+
+Instructions pour toute IA (Claude Code, Cursor, Copilot, ou autre) travaillant sur ce dépôt. Lis ceci avant de toucher au code.
+
+## Ce projet en une phrase
+
+`sinmonto` — moteur de décision événementiel, explicable, en Python pur, zéro dépendance. Voir `README.md` pour l'usage, `docs/constitution-finale.md` et `docs/constitution-noyau.md` pour l'architecture complète.
+
+## Règles non négociables
+
+Ne propose jamais d'architecture alternative aux 10 décisions ci-dessous. Ne les redébats pas. Si une impossibilité technique apparaît en implémentant réellement (pas en théorie), signale-la explicitement — ne la contourne pas en silence, ne modifie pas la spec toi-même pour l'éviter.
+
+1. Pas de réseau Rete complet — indexation alpha légère uniquement (par nom de champ).
+2. `Context` mutable pendant un cycle, figé en `FrozenContext` immuable à la fin (`commit()`) — jamais d'immuabilité totale à la façon persistante.
+3. `Signal` (déclencheur, porte `entity_id`) et `Fact` (information) sont deux types distincts.
+4. Effects-as-data : aucune règle n'exécute d'effet de bord. Elle retourne des `Effect` décrits ; un exécuteur séparé les applique.
+5. Explicabilité native : chaque condition, vraie ou fausse, doit être traçable via l'arbre `ConditionTrace`.
+6. Pas de durabilité multi-jours dans le cœur. `ContextStore`/`FactStore` abstraits, implémentations en mémoire par défaut.
+7. Temps injecté (`Clock`), jamais `time.time()` dans le moteur.
+8. `engine.compile()` verrouille la configuration ; aucune règle ajoutée après sans lever `EngineAlreadyCompiledError`.
+9. `__slots__` sur les objets internes chauds — jamais sur le `payload` utilisateur (reste un `dict` libre, exposé en lecture seule via `MappingProxyType`).
+10. Protocole `Evaluable` commun, classes distinctes (`Rule`, futures `Transition`) qui l'implémentent — pas de type générique fourre-tout.
+
+## Conventions de nommage et de fichiers
+
+- Tous les fichiers internes sont préfixés `_` (`_core.py`, `_engine.py`...), sans exception. Seul `__init__.py` est un chemin d'import public garanti — voir `docs/constitution-finale.md` §8.
+- Les 37 noms de `sinmonto.__all__` sont le contrat public stable (`from sinmonto import <nom>`). Ne jamais documenter ni recommander un import qualifié par module (`sinmonto._core.Fact`). (Avant 2026-08, cette ligne disait « seul `sinmonto.Symbole` » — un placeholder jamais rempli, corrigé en revue croisée.)
+- PEP8 strict. Verbes pour les actions (`evaluate`, `compile`, `commit`), noms pour les objets.
+
+## Tests
+
+Chaque module a son propre bloc `if __name__ == "__main__":` en bas de fichier, zéro dépendance de test (`_testing.py`, mini-runner interne). Pour tester un module isolément :
+
+```bash
+python3 -m sinmonto._core      # depuis le dossier PARENT de sinmonto/
+```
+
+Les imports internes sont relatifs (`from ._core import Fact`) — un module ne peut donc pas s'exécuter avec `python3 _core.py` en direct, seulement via `-m`.
+
+## État actuel (v0.1.0rc2 — preview technique)
+
+Fait et testé de bout en bout (41 tests, modules + intégration) : objets fondamentaux, contexte à deux phases avec persistance (`ContextStore`), trace d'explication en arbre, DSL avec opérateurs, moteur avec indexation alpha, tie-breaking déterministe, gestion d'erreur (`continue`/`fail_fast`/`fail_loud`).
+
+Corrigé en revue croisée multi-IA (2026-08) — voir `docs/journal-integration.md` : atomicité réelle des règles (snapshot/restore de `ctx`, y compris mutation directe), copie profonde du contexte, validation `Signal.entity_id`/opérateurs de condition/kind composite/retours d'action, copie défensive de `Fact._payload`, `causality` chaînée, code de sortie non nul du mini-runner sur échec.
+
+Pas encore fait, ne pas assumer que c'est câblé : file d'attente des signaux dérivés (`max_derived_depth`), mesure réelle de `duration_ms`, aplatissement des AND chaînés dans la trace. Voir `docs/roadmap-vision.md` et `docs/journal-integration.md` pour le détail et l'historique complet des décisions.
+
+## Processus
+
+Toute évolution architecturale (pas une simple implémentation) passe par `docs/contrat-vivant-gabarit.md` — mission écrite, rapport structuré en retour, synthèse avant verrouillage. Ne pas modifier `docs/constitution-finale.md` unilatéralement.

sinmonto-0.1.0rc3/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+Toutes les modifications notables de ce projet sont documentées dans ce fichier.
+Le format est basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/),
+et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/)
+(les versions `0.x.y` sont instables par convention — l'API n'est pas encore figée).
+
+L'historique détaillé — comment chaque bug a été trouvé et corrigé, y compris
+les fausses pistes — vit dans [`docs/journal-integration.md`](docs/journal-integration.md).
+Ce fichier-ci reste volontairement lisible en quelques minutes.
+
+## [Unreleased]
+
+### Changed
+- Racine du dépôt allégée : les documents de gouvernance (constitutions, journal
+  d'intégration, roadmap, contrat vivant) déplacés vers `docs/`. Aucun changement
+  fonctionnel du noyau.
+
+## [0.1.0rc3] - 2026-08-07
+
+### Fixed
+- `Fact.payload` / `Effect.payload` : copie **profonde** (`copy.deepcopy`) au lieu
+  d'une copie superficielle — une valeur imbriquée (liste, dict) mutée après
+  construction ne pouvait plus corrompre l'objet, mais restait encore accessible
+  en mutation directe à travers le proxy. `Effect.payload` n'avait auparavant
+  aucune protection du tout.
+- Packaging : `CLAUDE.md` (symlink vers `AGENTS.md`) correctement préservé lors
+  de la création d'archives (`zip -y`).
+
+### Changed
+- La garantie de déterminisme bit-à-bit (mêmes entrées ⇒ même sortie) exclut
+  désormais explicitement `DecisionTrace.trace_id` (UUID généré à chaque
+  évaluation, non reproductible par construction).
+
+## [0.1.0rc2] - 2026-08-07
+
+### Added
+- Atomicité réelle des règles : snapshot de `ctx._values` avant chaque
+  `rule.evaluate()`, restauré si la règle lève une exception — une mutation
+  directe via `ctx.set()` ne survit plus à un crash.
+- Validation `Signal.entity_id` contre `fact.entity_id` (`ValueError` explicite
+  si les deux sont fournis et diffèrent).
+- Validation à la construction des opérateurs `FieldCondition` et des `kind`
+  de `CompositeCondition` (`InvalidConditionError` immédiate).
+- `InvalidEffectError` sur un retour d'action non reconnu, ou un retour direct
+  d'`EvaluationResult` (désormais interdit — pouvait écraser la trace déjà
+  calculée par la règle).
+- Copie défensive de `Fact._payload` à la construction.
+- `causality` chaînée : `(fact.fact_id, *fact.causality)` pour un fait,
+  `(signal.signal_id,)` pour un timer (au lieu de vide).
+- Code de sortie non nul du mini-runner de tests (`_testing.py`) en cas
+  d'échec — exploitable en CI.
+
+### Fixed
+- Copie profonde du contexte à `commit()` et au rechargement d'un
+  `FrozenContext` existant — un objet imbriqué muté après coup ne corrompt
+  plus rétroactivement un état déjà figé.
+- `InMemoryFactStore(max_facts=0)` lève un `ValueError` clair au lieu d'un
+  `IndexError` obscur.
+
+### Changed
+- Contrat public clarifié : les 37 noms de `sinmonto.__all__` sont la
+  surface stable, remplaçant un placeholder de documentation ("Symbole")
+  jamais réellement implémenté.
+- Version, licence (Apache-2.0) et nom du package verrouillés de façon
+  cohérente dans tous les fichiers de gouvernance.
+
+## [0.1.0-rc1] - 2026-08-04
+
+### Added
+- Première version assemblée et testée de bout en bout du noyau `sinmonto`.
+- Objets fondamentaux : `Fact`, `Signal`, `Effect`, `Decision`, `EvaluationResult`,
+  horloge injectée (`Clock` / `ManualClock`).
+- Contexte à deux phases (`EvaluationContext` mutable → `FrozenContext` immuable
+  via `commit()`), avec persistance par entité (`ContextStore` /
+  `InMemoryContextStore`).
+- DSL de conditions (`Field`, opérateurs, compositions AND/OR/NOT) et
+  décorateur `@rule`.
+- Moteur (`DecisionEngine`) : indexation alpha légère, `compile()` /
+  `evaluate()`, politiques d'erreur `continue` / `fail_fast` / `fail_loud`.
+- Traces d'explication en arbre (`ConditionTrace`, `RuleTrace`, `DecisionTrace`).
+- Tie-breaking déterministe à priorité égale (ordre d'insertion stable).
+- Suite de tests interne sans dépendance externe (mini-runner par module +
+  `examples/end_to_end.py`).
+
+### Known limitations (assumées, documentées dès le départ)
+- Signaux dérivés acceptés par l'API mais non traités (pas de cascade de règles).
+- `RuleTrace.duration_ms` toujours à zéro (non mesuré).
+- Pas de fenêtres temporelles, de FSM, ni de `engine.replay()`.

sinmonto-0.1.0rc3/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

sinmonto-0.1.0rc3/CONTRIBUTING.md

@@ -0,0 +1,120 @@
+# Contribuer à sinmonto
+
+Merci de t'intéresser à `sinmonto` (*Sɛ́n mɔto*, fon pour « moteur de règle »).
+
+Ce projet a été développé en solo depuis un téléphone (Termux, Android — pas
+de PC), avec une gouvernance multi-IA inhabituelle : les décisions
+architecturales passent par des revues croisées documentées, pas par une
+seule opinion. Une contribution externe est bienvenue, dans ce cadre.
+
+## Avant de commencer
+
+1. Lis [`README.md`](README.md) — usage et limitations connues.
+2. Lis [`docs/constitution-finale.md`](docs/constitution-finale.md) §2 — les
+   **10 décisions architecturales verrouillées**. Elles ne se redébattent pas
+   dans une issue ou une PR. Si une impossibilité technique réelle apparaît
+   en implémentant (pas en théorie), signale-la explicitement — ne la
+   contourne pas en silence.
+3. Si tu touches au noyau : [`AGENTS.md`](AGENTS.md) pour les conventions de
+   code et la routine de vérification exacte.
+
+## Les 10 décisions verrouillées
+
+1. Pas de réseau Rete complet — indexation alpha légère uniquement.
+2. `Context` mutable pendant un cycle d'évaluation, figé en `FrozenContext`
+   immuable à la fin (`commit()`).
+3. `Signal` (déclencheur) et `Fact` (information) sont deux types distincts.
+4. Effects-as-data : aucune règle n'exécute d'effet de bord — elle retourne
+   des `Effect` décrits, un exécuteur séparé les applique.
+5. Explicabilité native — chaque condition, vraie ou fausse, doit être
+   traçable.
+6. Pas de durabilité multi-jours dans le cœur (`ContextStore`/`FactStore`
+   abstraits, implémentations mémoire par défaut).
+7. Temps injecté (`Clock`), jamais `time.time()` dans le moteur.
+8. `engine.compile()` verrouille la configuration.
+9. `__slots__` sur les objets internes chauds — jamais sur le `payload`
+   utilisateur.
+10. Protocole `Evaluable` commun, classes distinctes qui l'implémentent.
+
+## Le filtre v1.0
+
+Avant de proposer une fonctionnalité : *« est-ce que ça rapproche réellement
+la v1.0, ou est-ce qu'on rêve d'une fonctionnalité qui n'a peut-être jamais
+besoin d'exister maintenant ? »* Si c'est la seconde réponse, l'idée a sa
+place dans [`docs/roadmap-vision.md`](docs/roadmap-vision.md), pas dans le
+noyau tout de suite.
+
+## Installer et lancer les tests
+
+```bash
+git clone https://github.com/RuleLabs/sinmonto.git
+cd sinmonto
+pip install -e .
+```
+
+Zéro dépendance de runtime ni de test — pas de `pytest`. Chaque module a son
+propre bloc `if __name__ == "__main__":` qui fait tourner le mini-runner
+interne (`_testing.py`). Depuis la racine du dépôt :
+
+```bash
+python3 -m sinmonto._exceptions
+python3 -m sinmonto._core
+python3 -m sinmonto._trace
+python3 -m sinmonto._testing
+python3 -m sinmonto._context
+python3 -m sinmonto._dsl
+python3 -m sinmonto._engine
+python3 examples/end_to_end.py
+```
+
+*(`./scripts/test_all.sh` fait tourner cette liste en une commande.)*
+
+Les imports internes sont relatifs : un module ne s'exécute pas avec
+`python3 sinmonto/_core.py` en direct, uniquement via `python3 -m sinmonto._core`
+depuis le dossier **parent** de `sinmonto/`. Un échec sort avec un code non
+nul (`os._exit(1)`), exploitable en CI.
+
+## Comment proposer un changement
+
+**Typo, lien cassé, correction de doc** — PR directe, pas besoin d'issue.
+
+**Correction de bug** — Ouvre une issue courte (comportement attendu vs
+observé, comment reproduire, sortie du mini-runner si pertinent). Une PR
+peut suivre immédiatement si tu as déjà le correctif.
+
+**Évolution architecturale** (nouvelle fonctionnalité, changement de
+comportement, nouvelle primitive) — Ouvre une issue d'abord. Ne commence pas
+le code avant que la direction soit validée. Ces décisions passent par le
+processus du **contrat vivant** ([`docs/contrat-vivant-gabarit.md`](docs/contrat-vivant-gabarit.md)) :
+mission écrite, revues croisées, rapport structuré, synthèse avant
+verrouillage. Tu peux y participer — proposer une mission, répondre à un
+rapport — mais la décision finale revient au mainteneur.
+
+### Ce qu'on attend dans une PR
+- Un changement net, un périmètre clair — pas de refonte cachée dans un
+  patch de trois lignes.
+- Les tests concernés lancés localement, et `examples/end_to_end.py`.
+- La doc mise à jour (`README.md`, `CHANGELOG.md`, ou `docs/`) si le
+  comportement visible change.
+- Aucun import direct depuis un module interne (`from sinmonto._core import
+  Fact`) — seule la surface `sinmonto.__all__` (37 noms) est garantie.
+
+## Le ton attendu
+
+[`docs/journal-integration.md`](docs/journal-integration.md) documente
+honnêtement les bugs, les fausses pistes et les erreurs de revue — la
+tienne y compris, le cas échéant. Ce n'est pas une gêne à cacher, c'est une
+valeur du projet. *« J'ai d'abord essayé X, ça ne marchait pas parce que Y,
+j'ai finalement opté pour Z »* est un format de description de PR
+parfaitement valide ici — préférable à un historique lissé.
+
+## Revue
+
+Le dépôt est géré en solo, en preview 0.x. Le délai de réponse peut varier
+selon la disponibilité du mainteneur (depuis son téléphone). Pas d'exigence
+de SLA ; un ping poli après deux semaines sans nouvelles est bienvenu.
+
+## Licence
+
+En contribuant, tu acceptes que ta contribution soit publiée sous la licence
+du projet : [Apache License 2.0](LICENSE).

sinmonto-0.1.0rc3/LICENSE

@@ -0,0 +1,193 @@
+                                 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
+
+   Copyright 2026 Clarel Gnimadi
+
+   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.