aetherius 0.2.0__tar.gz → 0.3.0__tar.gz

aetherius-0.3.0/.dockerignore

@@ -0,0 +1,11 @@
+# Contexte de build Docker (deploy/Dockerfile, contexte = racine du depot).
+# Allowlist : seul ce que le Dockerfile copie entre dans le contexte — le reste (dont .env et
+# tout secret local) est exclu par construction.
+*
+!pyproject.toml
+!README.md
+!LICENSE
+!src
+!examples
+**/__pycache__
+**/*.pyc

{aetherius-0.2.0 → aetherius-0.3.0}/.env.example

@@ -18,3 +18,11 @@ AETHERIUS_SECRET_QUOTES_PASS=demo
 # Universite de Bordeaux ENT/CAS.
 AETHERIUS_SECRET_BORDEAUX_USER=your-username
 AETHERIUS_SECRET_BORDEAUX_PASS='your-password'
+
+# Notification targets (see docs/notifications.md) — uncomment the channels you use.
+# A channel address grants write (and for ntfy, read) access: keep them out of Blueprints.
+# AETHERIUS_SECRET_WEBHOOK_URL=https://webhook.site/<your-uuid>
+# AETHERIUS_SECRET_DISCORD_WEBHOOK=https://discord.com/api/webhooks/<id>/<token>
+# AETHERIUS_SECRET_TELEGRAM_BOT_TOKEN=123456:bot-token
+# AETHERIUS_SECRET_TELEGRAM_CHAT_ID=123456789
+# AETHERIUS_SECRET_NTFY_TOPIC=my-private-topic

aetherius-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,92 @@
+# Automated release. Publishing lives here (as infra), not in a doc to remember.
+#
+# To cut a release:
+#   1. Bump the version in BOTH src/aetherius/version.py and sdks/typescript/package.json (same X.Y.Z).
+#   2. Add a "## [X.Y.Z] - <date>" section at the top of CHANGELOG.md (becomes the release notes).
+#   3. Commit, then: git tag vX.Y.Z && git push && git push --tags
+#
+# Pushing the tag triggers this workflow, which — after checking the tag matches the versions —
+# publishes to PyPI and npm and creates the GitHub Release. Nothing else to run by hand.
+#
+# One-time setup (see the pinned note): a PyPI "trusted publisher" for this repo (no token), and an
+# NPM_TOKEN repository secret (npm automation token).
+
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  check-version:
+    name: Tag matches package versions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Verify tag == version.py == package.json
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          py=$(python3 -c "import re,pathlib; print(re.search(r'__version__\s*=\s*\"([^\"]+)\"', pathlib.Path('src/aetherius/version.py').read_text()).group(1))")
+          ts=$(node -p "require('./sdks/typescript/package.json').version")
+          echo "tag=$tag  python=$py  npm=$ts"
+          test "$tag" = "$py" || { echo "::error::Tag $tag != Python version $py (bump src/aetherius/version.py)"; exit 1; }
+          test "$tag" = "$ts" || { echo "::error::Tag $tag != npm version $ts (bump sdks/typescript/package.json)"; exit 1; }
+
+  pypi:
+    name: Publish to PyPI
+    needs: check-version
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # OIDC for PyPI trusted publishing (no token stored)
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python3 -m pip install build
+      - run: python3 -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  npm:
+    name: Publish to npm
+    needs: check-version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm install --no-audit --no-fund
+        working-directory: sdks/typescript
+      - run: npm run build
+        working-directory: sdks/typescript
+      - run: npm publish --access public
+        working-directory: sdks/typescript
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  github-release:
+    name: GitHub Release
+    needs: [pypi, npm]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Extract the CHANGELOG section for this version
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          awk -v ver="$version" '
+            $0 ~ "^## \\[" ver "\\]" { f=1; next }
+            /^## \[/ { if (f) exit }
+            f { print }
+          ' CHANGELOG.md > release-notes.md
+          [ -s release-notes.md ] || echo "Release ${GITHUB_REF_NAME}." > release-notes.md
+      - name: Create the release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "$GITHUB_REF_NAME" --title "$GITHUB_REF_NAME" --notes-file release-notes.md

aetherius-0.3.0/CHANGELOG.md

@@ -0,0 +1,189 @@
+# Changelog
+
+Toutes les évolutions notables du projet sont consignées ici. Le format s'inspire de
+[Keep a Changelog](https://keepachangelog.com/fr/1.1.0/) et le versionnage suit
+[SemVer](https://semver.org/lang/fr/). Tant que la version reste en `0.x`, l'API publique peut encore
+évoluer entre deux versions mineures (durcissement de la Phase 1 en conditions réelles).
+
+## [Non publié]
+
+## [0.3.0] - 2026-07-17
+
+Phase 1.5 : le socle devient **opérationnel** (planification, alertes, réactivité, furtivité réseau
+et empreinte), et durcissement du socle Phase 1 avant d'entamer la Phase 2 (audit croisé de la doc).
+
+### Ajouté
+- **Durcissement de l'empreinte (Jalon 1.5-H)** — les signaux à forte valeur que le profil laissait à
+  découvert sont fermés **de façon cohérente avec le profil actif** (un signal masqué mais incohérent
+  est un tell pire que l'absence de masque). Côté navigateur,
+  [`stealth/fingerprint/hardening.py`](src/aetherius/stealth/fingerprint/hardening.py) injecte, après
+  le script de cohérence du profil, un init script masquant : **Canvas** (`toDataURL`/`toBlob`/
+  `getImageData`) et **AudioContext** avec un bruit **déterministe par profil** (seed calculé côté
+  Python, hachage JS — stable entre deux lectures d'un même run, différent d'un profil à l'autre, lu
+  depuis une copie offscreen pour ne pas s'accumuler), **polices** (`measureText`), **client hints**
+  (`navigator.userAgentData`), **écran** (`screen.*` + `devicePixelRatio`) et **WebGL2**
+  (`getParameter`). Côté **Vector** (Act I, sans discrétion jusqu'ici),
+  [`stealth/fingerprint/headers.py`](src/aetherius/stealth/fingerprint/headers.py) donne une identité
+  d'en-têtes par défaut (`User-Agent`, `Sec-CH-UA`/`-Mobile`/`-Platform`, `Accept`, `Accept-Language`
+  aligné sur la géo) supprimant la signature « client HTTP nu » — **opt-in** (injectée seulement quand
+  `options.stealth` nomme un profil, un run sans stealth reste inchangé), les en-têtes explicites du
+  Blueprint gardant la priorité (fusion insensible à la casse) ; l'impersonation TLS `curl_cffi` garde
+  ses propres en-têtes. Le `FingerprintProfile` gagne les champs `screen`/`device_pixel_ratio`/
+  `ua_platform`/`ua_full_version` et dérive `Sec-CH-UA` de sa propre version d'UA : la limite « UA-CH
+  drift » est **levée**. Exemples exécutables zéro config
+  `examples/continuum/fingerprint-hardening.blueprint.json` et
+  `examples/vector/http-headers-identity.blueprint.json`. Voir [docs/stealth.md](docs/stealth.md).
+- **Identité réseau (Jalon 1.5-G)** — option `options.proxy` de premier niveau qui rend le bot
+  invisible **au niveau réseau**, pour les **deux** moteurs (la couche stealth ne touche que le
+  navigateur). Le module `aetherius.network` est activé : `parse_proxy`/`ProxySpec` (rendu httpx et
+  Playwright, credentials masqués dans les logs), `ProxyPool` (rotation `per_run`/`round_robin`/
+  `random`/`sticky` — l'IP change d'un run à l'autre, ou reste stable par clé), `geo_hint` (cohérence
+  timezone/locale/langues avec le pays de l'IP), `resolve_identity` (option du Blueprint > défaut
+  d'environnement `AETHERIUS_PROXY_*` > aucun). Vector route par `httpx.Client(proxy=...)`
+  (HTTP/HTTPS, plus SOCKS5 via l'extra `[network]` avec garde typée si absent) et peut imiter la
+  poignée de main TLS d'un vrai navigateur (JA3/JA4) via un transport `curl_cffi` isolé
+  (`acts/vector/impersonate.py`, extra `[network]`, `DependencyError` claire sinon). Continuum lie le
+  proxy au lancement du contexte, force l'anti-fuite WebRTC (flag Chromium `disable_non_proxied_udp`
+  + init-script filtrant les candidats ICE locaux — indispensable, sinon le proxy laisse fuir l'IP
+  réelle) et dérive le profil d'empreinte pour coller à la géo (timezone/locale/`navigator.languages`
+  alignés sur l'IP, vérifiés sur Chromium réel). Identifiants **jamais** stockés dans le Blueprint
+  (`{{ secrets.x }}`). Le Studio préserve `options.proxy` verbatim (aucune régression à l'édition).
+  Exemple exécutable `examples/vector/ip-echo-proxy.blueprint.json` (nécessite un proxy via `.env`).
+  Voir [docs/network.md](docs/network.md).
+- **Déploiement always-on (Jalon 1.5-F)** — recette 24/7 vérifiée de bout en bout pour héberger le
+  daemon (et donc le scheduler) sur un hôte toujours allumé : VPS, Raspberry Pi, NAS. Les brouillons
+  `deploy/` sont finalisés : image Docker multi-stage (wheel construit à part, image finale sans
+  sources ni outils de build), utilisateur non-root, `HEALTHCHECK` sur `/health`, exemples embarqués
+  comme sondes zéro config, variante Act II exécutable (`--build-arg BROWSER=1` : extra `[browser]` +
+  Chromium sous `PLAYWRIGHT_BROWSERS_PATH` partagé) ; `docker-compose.yml` (volume persistant unique
+  `/data`, port publié sur la loopback de l'hôte, `env_file` + `.env.example`, montage lecture seule
+  `blueprints/` — les schedules résolvent des chemins côté conteneur) ; service systemd utilisateur
+  (`enable-linger`, `EnvironmentFile` optionnel, redémarrage automatique) ; `.dockerignore` racine en
+  allowlist (l'ancien `deploy/.dockerignore` était inopérant, le contexte de build étant la racine).
+  Durcissement afférent : un `AETHERIUS_DAEMON_TOKEN` vide vaut absence de token — l'interpolation
+  compose (`${VAR:-}`) n'active plus l'auth par accident (`server/config.py`, test miroir). Doc
+  complète (recettes, persistance, sauvegarde SQLite, sécurité : loopback par défaut, exposer =
+  token + reverse proxy TLS) : voir [docs/deployment.md](docs/deployment.md).
+- **Actions custom / plugins (Jalon 1.5-E)** — points d'extension activés : un paquet tiers ajoute
+  des actions de Blueprint et des canaux de notification sans forker le cœur. Découverte par
+  entry-points (`aetherius.actions`, `aetherius.notify_channels`) dans le nouveau module
+  `aetherius.plugins` (`load_plugins()` idempotent, appelé au démarrage par la CLI, le lifespan du
+  daemon et `RunEngine.run` ; surface d'import unique pour les auteurs de plugins). Le registre
+  d'actions dormant est activé : une action plugin embarque son `ActionSpec` (visible du Studio et
+  des validators, invariant « registre = source, catalogue = projection » préservé), est
+  **act-agnostique** (hors capability-table, validée dynamiquement) et dispatchée par les drivers
+  en repli après leur `match` built-in. Gardes de collision sur les deux registres (les built-ins
+  restent prioritaires, un conflit est un échec de chargement explicite) et pannes isolées (un
+  plugin qui lève à l'import est loggé et sauté, jamais fatal). Plugin d'exemple exécutable
+  (`examples/plugins/` : action `demo.slugify` + canal `logfile` + Blueprint zéro réseau), chargé
+  par de vrais entry-points dans les tests. Voir [docs/plugins.md](docs/plugins.md).
+- **Écran Console « Schedules »** — l'UI du scheduler (Jalon 1.5-D) dans la Console : liste des
+  schedules (trigger, politique d'alerte, statut, prochains/derniers tirs en heure locale, sonde
+  d'honnêteté « daemon actif ou non »), pause/reprise (`p`, la reprise recale la cadence),
+  suppression confirmée (`d`, nouveau `ConfirmModal` réutilisable), **détail** avec l'historique
+  des runs du schedule et un **tir manuel** aux événements streamés en direct (même brique
+  in-process que `aetherius schedule run`, extraite dans `server/scheduler/manual.py::fire_schedule`
+  et partagée CLI/Console), et **formulaire guidé** de création/édition (inputs du Blueprint en
+  champs, secrets jamais saisis — état `.env` affiché, trigger/misfire/notify validés à la
+  sauvegarde). Raccourci `s` dans Library pour planifier le Blueprint surligné. Captures SVG
+  déterministes (fuseau épinglé, store de démo figé) et neutralisation renforcée des chemins
+  (le home ne fuit plus, même tronqué dans une colonne). Voir [docs/console.md](docs/console.md).
+- **Scheduler intégré au daemon (Jalon 1.5-D)** — rejeu persistant d'un Blueprint à heure fixe
+  (cron à 5 champs, évalué dans le fuseau local, DST gérés via `tzlocal`), par intervalle ou en tir
+  unique (`at`). Boucle de tick dans le lifespan du daemon (30 s, `AETHERIUS_DAEMON_SCHEDULER_TICK_SECONDS`) ;
+  un run planifié passe par `RunManager.submit` — mêmes événements, même historique, plus le lien
+  `schedule_id`. Rattrapage des tirs manqués par politique `misfire` (`skip`/`run_once`/`run_all`,
+  portée par le trigger, résolue par le tick au-delà d'une fenêtre de grâce) et politique d'alerte
+  par schedule (`failure`/`success`/`always`/`change` — la dédup au changement d'état s'appuie sur
+  `state.compare_and_set`, cibles `{{ secrets.x }}` rendues au tir, jamais persistées). CLI
+  `aetherius schedule add|list|rm|pause|resume|run` (écrit directement dans le store : marche daemon
+  éteint ; `cli.py` devient le package `cli/`) et API `/v1/schedules` (CRUD + tir immédiat,
+  contrat OpenAPI à jour). Exemple zéro config : `examples/vector/quotes-watch.blueprint.json`.
+  Dépendances : `croniter` (déjà déclarée) + `tzlocal`. Voir [docs/scheduler.md](docs/scheduler.md).
+- **Notifications natives (Jalon 1.5-C)** — couche d'alerte sans dépendance nouvelle (`notify/`) :
+  quatre canaux built-in en un POST `httpx` chacun (webhook générique, Discord, Telegram, ntfy pour
+  la push téléphone, en mode JSON publishing), action `notify` Act-agnostique (handler partagé, se
+  combine à `when`), `NotifySink` de fin de run (`failure`/`success`/`always`) et registre de canaux
+  prêt pour les plugins (Jalon E). Échec d'envoi contenu : jamais fatal au run, `delivered` exposé
+  dans les outputs du step. Exemple zéro config :
+  `examples/vector/books-restock-notify.blueprint.json`. Voir
+  [docs/notifications.md](docs/notifications.md).
+- **Réactivité et flux conditionnel (Jalon 1.5-B)** — garde d'étape `when` universelle (évaluée
+  avant dispatch, même règle de véracité que `assert` ; step sauté = statut `skipped` + événement
+  `step_skipped`, contrats et SDK TypeScript à jour) et actions `if`/`repeat`/`for_each` exécutées
+  par un **exécuteur récursif** dans le moteur (`core/runtime/steps.py`), en amont des drivers —
+  tous les Acts en héritent sans câblage, `repeat` rejoint les capacités Vector. Variable de boucle
+  `as` (défaut `item`) exposée au template le temps de l'itération, validation sémantique récursive
+  des branches, identifiants de steps imbriqués traçables (`loop[2].fetch`), schéma des steps
+  formalisé (`when`, `then`/`else`/`steps`). Deux exemples zéro config dans `examples/vector/`.
+  Voir [docs/blueprint-schema.md](docs/blueprint-schema.md).
+- **Persistance durable (Jalon 1.5-A)** — socle de stockage SQLite (stdlib `sqlite3`, mode WAL, zéro
+  dépendance) sous `~/.aetherius/aetherius.db`, avec migrations versionnées (`PRAGMA user_version`) et
+  trois dépôts typés : schedules, historique des runs, état clé/valeur inter-run (`compare_and_set`
+  pour la déduplication d'alertes). Le daemon persiste désormais le résultat de ses runs dans le store
+  (migration douce, sans régression). Voir [docs/store.md](docs/store.md).
+- **Cadrage Phase 1.5** — squelette (stubs, interfaces, contrats) et spécifications par jalon pour
+  rendre le socle **récurrent, réactif et furtif** : persistance SQLite (`store/`), notifications
+  natives (`notify/`), scheduler du daemon, flux conditionnel (`when`, `if`/`repeat`/`for_each`),
+  plugins, déploiement 24/7, **identité réseau** (`network/` : proxy, rotation d'IP, anti-fuite
+  WebRTC, cohérence géo, impersonation TLS) et **durcissement de l'empreinte**
+  (`stealth/fingerprint/` : canvas/audio/UA-CH/écran/WebGL2 + identité d'en-têtes pour Vector).
+  Aucune capacité n'est encore activée (jalons en attente : l'action `notify` est déclarée mais
+  marquée `PENDING`, les modules lèvent une erreur « jalon en attente ») ; `make check` reste vert.
+  Nouvel extra optionnel `[network]` (SOCKS5 + `curl_cffi`). Voir [docs/phase-1.5/](docs/phase-1.5/README.md).
+- **Suivi des nouveaux onglets (Act II — Continuum)** : un clic ouvrant un onglet (`target="_blank"`,
+  `window.open`) rend la nouvelle page active pour les steps suivants, avec retombée sur une page
+  survivante si l'onglet actif se referme. Auparavant les steps restaient bloqués sur l'onglet initial.
+- **Recorder « Make input »** : le `type`/`format` de l'input produit est inféré du type HTML du champ
+  (`number`, `date`+`format`, `email`/`url`, …) au lieu d'un `string` générique.
+
+### Sécurité
+- **Évaluateur `where` (Act I — Vector)** : rejet explicite des attributs magiques (`__class__`,
+  `__globals__`, tout nom en `__`) dans l'AST-walk. L'allowlist de nœuds bloquait déjà l'exécution de
+  code, mais la traversée d'attributs dunder combinée à une comparaison restait un oracle booléen sur
+  le graphe d'objets Python — la garde ferme cette évasion de sandbox sans dépendre de l'absence
+  d'appels/indexation.
+
+### Corrigé
+- **`precise_sleep` (stealth/humanizer)** : le busy-wait pur sous 20 ms saturait un cœur CPU à 100 %
+  (chaque point de geste souris), risque de privation de ressources sur le daemon en multi-run.
+  Désormais `time.sleep` cède le CPU pour le gros du délai et le busy-wait ne couvre que la queue
+  (~1,5 ms) — précision de timing inchangée, CPU au repos (~9 %).
+- **Debug (Act II — Continuum)** : quand les entrées sont humanisées, `slow_mo` est à 0 et les actions
+  brutes (`select`, `upload`, `navigate`, …) défilaient instantanément, illisibles en debug. Elles
+  reçoivent maintenant un délai manuel équivalent.
+
+## [0.2.0] - 2026-07-10
+
+Première release publique. Elle clôt la **Phase 1** : le socle d'Aetherius, utilisable comme
+**bibliothèque** (in-process Python) et comme **service** (daemon local + SDK), avec sa Console.
+
+### Ajouté
+- **Daemon local (FastAPI)** — passerelle HTTP + WebSocket exposant le moteur à tout langage
+  (`aetherius serve`, bind loopback, token bearer optionnel) : `POST /v1/runs`, `GET /v1/runs/{id}`,
+  `WS /v1/runs/{id}/events` (rejeu bufferisé + flux live jusqu'à `done`), `POST /v1/blueprints/validate`,
+  `GET /v1/schema`, `GET /health`. L'enregistrement reste host-local (`POST /v1/recorder/sessions` → 501).
+  Voir [docs/daemon.md](docs/daemon.md).
+- **SDK TypeScript** `@aetherius/client` (Node 20+) — spawn du daemon (ou `baseUrl`),
+  `client.run(blueprint, { inputs, secrets, onEvent })`, streaming d'événements typé.
+- **Console : écran Settings** — démarrer/arrêter le daemon et voir son statut, sans quitter le terminal.
+- **Act I — Vector** : client HTTP/API (requêtes, retries/backoff, 5 stratégies d'auth, extraction
+  JSONPath et CSS/XPath, moteur de templates Jinja2).
+- **Act II — Continuum** : automatisation d'un vrai navigateur (Playwright, extra `[browser]`) —
+  navigation, interactions, extraction DOM, `wait_for` avec échec nommé, sessions persistantes, debug.
+- **Système de discrétion (stealth)** : couche transverse (`options.stealth`) — souris humaine par
+  rejeu géométrique de gestes, clavier/scroll/timing humains, fingerprint, warmup de profil.
+- **Recorder** : création de Blueprint par démonstration (Continuum et Vector) + gesture recorder.
+- **Builder headless + Blueprint Studio** : construction guidée de Blueprints sans JSON, avec aperçu
+  validé en direct, réutilisable par la Console, le daemon et les SDKs.
+- **Console (Textual)** : Library, Runs, Catalog, Recorder, Blueprint Studio, Settings.
+- **Contrats** langage-agnostiques (`contracts/`) : schéma Blueprint, OpenAPI du daemon, schéma
+  d'événements — source de vérité, gardés par des tests.
+
+### Notes
+- SemVer `0.x` : l'API peut évoluer pendant le durcissement de la Phase 1.
+- La **Phase 2** ajoutera Act III (Oracle, vision) et Act IV (Phantom, agent autonome).
+
+[Non publié]: https://github.com/kln-mltre/Aetherius/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/kln-mltre/Aetherius/releases/tag/v0.3.0
+[0.2.0]: https://github.com/kln-mltre/Aetherius/releases/tag/v0.2.0

{aetherius-0.2.0 → aetherius-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aetherius
-Version: 0.2.0
+Version: 0.3.0
 Summary: A fixed, robust web-bot engine driven by declarative instruction files (Blueprints).
 Project-URL: Repository, https://github.com/kln-mltre/Aetherius
 Author: Kylian Malartre
@@ -18,6 +18,7 @@ License: Aetherius
 License-File: LICENSE
 Keywords: agent,automation,bot,browser,playwright,scraping,stealth
 Requires-Python: >=3.11
+Requires-Dist: croniter>=2.0
 Requires-Dist: fastapi>=0.110
 Requires-Dist: httpx>=0.27
 Requires-Dist: jinja2>=3.1
@@ -33,17 +34,20 @@ Requires-Dist: rich>=13.7
 Requires-Dist: tenacity>=8.2
 Requires-Dist: textual>=0.60
 Requires-Dist: typer>=0.12
+Requires-Dist: tzlocal>=5.0
 Requires-Dist: uvicorn[standard]>=0.29
 Requires-Dist: websockets>=12.0
 Provides-Extra: agent
 Requires-Dist: anthropic>=0.25; extra == 'agent'
 Provides-Extra: all
 Requires-Dist: anthropic>=0.25; extra == 'all'
+Requires-Dist: curl-cffi>=0.6; extra == 'all'
 Requires-Dist: numpy>=1.26; extra == 'all'
 Requires-Dist: onnxruntime>=1.17; extra == 'all'
 Requires-Dist: opencv-python-headless>=4.9; extra == 'all'
 Requires-Dist: pillow>=10.3; extra == 'all'
 Requires-Dist: playwright>=1.44; extra == 'all'
+Requires-Dist: socksio>=1.0; extra == 'all'
 Provides-Extra: browser
 Requires-Dist: playwright>=1.44; extra == 'browser'
 Provides-Extra: dev
@@ -54,6 +58,9 @@ Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.1; extra == 'dev'
 Requires-Dist: ruff>=0.4; extra == 'dev'
 Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: network
+Requires-Dist: curl-cffi>=0.6; extra == 'network'
+Requires-Dist: socksio>=1.0; extra == 'network'
 Provides-Extra: stealth
 Requires-Dist: numpy>=1.26; extra == 'stealth'
 Provides-Extra: vision
@@ -315,8 +322,9 @@ aetherius            # ouvre la Console
 
 ![La Console Aetherius : écran d'accueil](docs/screenshots/home.svg)
 
-> **État actuel** : la Console est navigable de bout en bout. Library, Runs, Catalog, le **Recorder**,
-> le **Blueprint Studio** et **Settings** (démarrer/arrêter le daemon) sont pleinement fonctionnels
+> **État actuel** : la Console est navigable de bout en bout. Library, Runs, **Schedules** (runs
+> récurrents : liste, tir manuel, historique, création guidée), Catalog, le **Recorder**, le
+> **Blueprint Studio** et **Settings** (démarrer/arrêter le daemon) sont pleinement fonctionnels
 > pour Act I (Vector) et Act II (Continuum, avec l'extra `[browser]`) ; seul **Sessions** affiche
 > honnêtement son jalon en attente (stealth/session). Détails : [docs/console.md](docs/console.md).
 
@@ -456,20 +464,25 @@ console.log(result.outputs.events);
 ```
 src/aetherius/
   core/        blueprint (models/loader/validator/template), actions (le dictionnaire),
-               runtime (engine/context/selector/result), extraction, events, errors, driver
+               runtime (engine/context/steps/selector/result), extraction, events, errors, driver
   acts/        vector (I), continuum (II), oracle (III), phantom (IV)
   stealth/     policy, humanizer (mouse/keyboard/scroll/timing), gestures, fingerprint,
                session (store/warmup), ml (optionnel)
   recorder/    blueprint_recorder, gesture_recorder, capture, selector_synth
   builder/     construction headless de Blueprint (factory, catalog, templates)
-  console/     interface terminale globale (Textual) : Blueprint Studio, runs, catalogue,
-               sessions, settings — la porte d'entrée de l'outil
+  console/     interface terminale globale (Textual) : Blueprint Studio, runs, schedules,
+               catalogue, sessions, settings — la porte d'entrée de l'outil
+  notify/      canaux d'alerte natifs (webhook/discord/telegram/ntfy) + registre ouvert aux plugins
+  store/       état durable SQLite sous ~/.aetherius : schedules, historique des runs, état inter-run
+  plugins.py   découverte des extensions tierces par entry-points (actions + canaux)
   models/      registry + cache des assets ML runtime
-  server/      daemon FastAPI (routes/jobs/schemas)
+  server/      daemon FastAPI (routes/jobs/schemas) + scheduler (triggers/misfire/alerts)
+  cli/         commandes scriptables (run/validate/serve/record, groupe schedule)
   config/      settings
 contracts/     blueprint.schema.json, openapi.yaml, events.schema.json  (source de vérité)
+deploy/        recette always-on : Dockerfile, docker-compose.yml, service systemd
 sdks/          typescript (@aetherius/client), python
-examples/      Blueprints de démonstration
+examples/      Blueprints de démonstration (par Act + plugins/)
 training/      entraînement des modèles Oracle (hors runtime)
 legacy_examples/  code de référence des projets d'origine (UKit, TikTok) + carte de provenance
 ```
@@ -521,7 +534,8 @@ Conventions de contribution (discipline de test, invariants, structure des tests
 Le projet avance en deux grandes phases. La **Phase 1** — le socle, utilisable comme **bibliothèque**
 (in-process Python) et comme **service** (daemon + SDK) — est **terminée avec ce jalon** : un premier
 point de contrôle, à éprouver en conditions réelles avant d'attaquer la **Phase 2** (les deux Acts les
-plus lourds).
+plus lourds). Entre les deux, une **Phase 1.5** durcit ce socle pour les workflows **récurrents et
+réactifs** (planification, alertes, réactivité) — voir ci-dessous.
 
 ### Phase 1 — le socle réutilisable (terminée)
 
@@ -589,6 +603,81 @@ plus lourds).
 **Phase 1 terminée.** Aetherius est utilisable comme bibliothèque et comme service ; c'est le point de
 contrôle prévu pour l'éprouver en conditions réelles et corriger avant la suite.
 
+### Phase 1.5 — socle opérationnel (en cours)
+
+Un palier intermédiaire, dans l'esprit du durcissement du socle : rendre Aetherius capable de porter
+des workflows **récurrents et réactifs** (planifier un Blueprint, réagir aux données extraites,
+alerter au bon moment) avant les Acts autonomes. Le cas fil rouge : surveiller un produit en rupture,
+vérifier plusieurs fois par jour, alerter au retour en stock. Et, dans la même veine furtive que la
+couche stealth, le rendre invisible **au niveau réseau** (proxy, rotation d'IP). Cadrage complet et
+**spécifications par jalon** : [docs/phase-1.5/](docs/phase-1.5/README.md).
+
+- [x] **Persistance (`store/`)** : état durable SQLite (stdlib) sous `~/.aetherius` — schedules,
+  historique des runs, état inter-run. Fondation des autres jalons. Le daemon y persiste désormais
+  l'historique de ses runs. [docs/store.md](docs/store.md),
+  [docs/phase-1.5/a-store.md](docs/phase-1.5/a-store.md).
+- [x] **Réactivité et flux conditionnel** : garde d'étape `when` universelle (step sauté = statut
+  `skipped` + événement `step_skipped`) et actions `if`/`repeat`/`for_each` exécutées récursivement
+  par le moteur sur tous les Acts (validation récursive des branches, variable de boucle `as`,
+  rend la réutilisation de session Continuum exprimable). Exemples zéro config dans
+  `examples/vector/`. [docs/blueprint-schema.md](docs/blueprint-schema.md),
+  [docs/phase-1.5/b-flow.md](docs/phase-1.5/b-flow.md).
+- [x] **Notifications natives** : couche d'alerte sans dépendance nouvelle (webhook générique,
+  Discord, Telegram, **ntfy** pour la push téléphone — un POST `httpx` chacun), action `notify`
+  Act-agnostique (handler partagé, se combine à `when`) + `NotifySink` de fin de run
+  (`failure`/`success`/`always`), registre de canaux prêt pour les plugins (Jalon E), échec d'envoi
+  contenu (jamais fatal au run, `delivered` exposé). La dédup au changement d'état est désormais
+  portée par le scheduler (Jalon D, politique `change`). Exemple zéro config :
+  `examples/vector/books-restock-notify.blueprint.json`. [docs/notifications.md](docs/notifications.md),
+  [docs/phase-1.5/c-notifications.md](docs/phase-1.5/c-notifications.md).
+- [x] **Scheduler (daemon)** : rejeu persistant d'un Blueprint à heure fixe (cron, fuseau local,
+  DST gérés) ou par intervalle, plus le tir unique (`at`). Intégré au daemon (lifespan FastAPI,
+  tick 30 s) ; un run planifié passe par `RunManager.submit` — indiscernable d'un run manuel, avec
+  le lien `schedule_id` dans l'historique. CLI `aetherius schedule add|list|rm|pause|resume|run`
+  (écrit directement dans le store : marche daemon éteint) et API `/v1/schedules` (CRUD + tir
+  immédiat). Rattrapage des tirs manqués par politique `misfire` (`skip`/`run_once`/`run_all`) et
+  politique d'alerte par schedule (`failure`/`success`/`always`/`change` — dédup au changement
+  d'état via le store). **Écran Console dédié** : liste, pause/reprise, suppression, détail avec
+  historique et tir manuel (événements en direct), formulaire de création/édition guidé, raccourci
+  `s` depuis Library. Exemple zéro config : `examples/vector/quotes-watch.blueprint.json`.
+  [docs/scheduler.md](docs/scheduler.md),
+  [docs/phase-1.5/d-scheduler.md](docs/phase-1.5/d-scheduler.md).
+- [x] **Actions custom / plugins** : points d'extension activés — un paquet tiers ajoute des
+  **actions** et des **canaux de notification** sans forker le cœur. Découverte par entry-points
+  (`aetherius.actions`, `aetherius.notify_channels`) chargée au démarrage (CLI, daemon, moteur
+  in-process) ; une action plugin embarque sa spec (visible du Studio et du validator, act-agnostique,
+  dispatchée en repli après les built-ins) ; gardes de collision (les built-ins restent prioritaires)
+  et pannes isolées (un plugin cassé est loggé et sauté, jamais fatal au démarrage). Plugin d'exemple
+  exécutable : `examples/plugins/` (action `demo.slugify` + canal `logfile`).
+  [docs/plugins.md](docs/plugins.md), [docs/phase-1.5/e-plugins.md](docs/phase-1.5/e-plugins.md).
+- [x] **Déploiement always-on** : recette 24/7 vérifiée de bout en bout pour héberger le daemon sur
+  une machine allumée (VPS, Raspberry Pi, NAS) — la réponse honnête au « hors machine ». Deux voies
+  dans [`deploy/`](deploy/) : image Docker durcie (multi-stage, non-root, healthcheck, variante Act
+  II via `--build-arg BROWSER=1`) + `docker-compose.yml` (volume persistant unique `/data`, port
+  publié sur la loopback de l'hôte, Blueprints utilisateur montés) et service systemd utilisateur
+  (`enable-linger`, redémarrage automatique). Tout l'état durable (schedules, historique, profils)
+  vit sous `AETHERIUS_DATA_DIR` et survit aux redémarrages ; sécurité par défaut : loopback, et
+  exposer exige token + reverse proxy TLS. [docs/deployment.md](docs/deployment.md),
+  [docs/phase-1.5/f-deployment.md](docs/phase-1.5/f-deployment.md).
+- [x] **Identité réseau** : option `options.proxy` de premier niveau atteignant les **deux** moteurs
+  (Vector httpx/curl_cffi, Continuum Playwright ; HTTP/HTTPS/SOCKS5). Rotation de l'IP par run
+  (`per_run`/`round_robin`/`random`/`sticky`, pool inline ou défaut d'environnement `AETHERIUS_PROXY_*`),
+  prévention de la fuite WebRTC (flag de lancement + init-script, liée au proxy), cohérence géo
+  (timezone/locale/langues alignés sur le pays de l'IP, écrasant le profil d'empreinte) et
+  impersonation TLS (JA3/JA4) pour Vector via l'extra `[network]`. Identifiants jamais stockés
+  (`{{ secrets.x }}`). Exemple : `examples/vector/ip-echo-proxy.blueprint.json` (nécessite un proxy).
+  [docs/network.md](docs/network.md), [docs/phase-1.5/g-network.md](docs/phase-1.5/g-network.md).
+- [x] **Durcissement de l'empreinte** : les signaux restants sont fermés **de façon cohérente avec le
+  profil** — Canvas et AudioContext (bruit déterministe par profil, stable entre deux lectures),
+  énumération des polices (`measureText`), client hints (`Sec-CH-UA` / `navigator.userAgentData`
+  dérivés de l'UA du profil, la limite « UA-CH drift » est levée), dimensions d'écran /
+  `devicePixelRatio` et WebGL2. Vector (Act I) gagne une **identité d'en-têtes par défaut** (UA +
+  client hints + `Accept-Language` alignés) quand `options.stealth` nomme un profil, sans écraser les
+  en-têtes explicites du Blueprint ni rien changer aux runs sans stealth. Exemples zéro config :
+  `examples/continuum/fingerprint-hardening.blueprint.json` et
+  `examples/vector/http-headers-identity.blueprint.json`. [docs/stealth.md](docs/stealth.md),
+  [docs/phase-1.5/h-fingerprint.md](docs/phase-1.5/h-fingerprint.md).
+
 ### Phase 2 — les Acts autonomes (à venir)
 
 - [ ] Act III — Oracle (vision + entraînement).

{aetherius-0.2.0 → aetherius-0.3.0}/README.md

@@ -250,8 +250,9 @@ aetherius            # ouvre la Console
 
 ![La Console Aetherius : écran d'accueil](docs/screenshots/home.svg)
 
-> **État actuel** : la Console est navigable de bout en bout. Library, Runs, Catalog, le **Recorder**,
-> le **Blueprint Studio** et **Settings** (démarrer/arrêter le daemon) sont pleinement fonctionnels
+> **État actuel** : la Console est navigable de bout en bout. Library, Runs, **Schedules** (runs
+> récurrents : liste, tir manuel, historique, création guidée), Catalog, le **Recorder**, le
+> **Blueprint Studio** et **Settings** (démarrer/arrêter le daemon) sont pleinement fonctionnels
 > pour Act I (Vector) et Act II (Continuum, avec l'extra `[browser]`) ; seul **Sessions** affiche
 > honnêtement son jalon en attente (stealth/session). Détails : [docs/console.md](docs/console.md).
 
@@ -391,20 +392,25 @@ console.log(result.outputs.events);
 ```
 src/aetherius/
   core/        blueprint (models/loader/validator/template), actions (le dictionnaire),
-               runtime (engine/context/selector/result), extraction, events, errors, driver
+               runtime (engine/context/steps/selector/result), extraction, events, errors, driver
   acts/        vector (I), continuum (II), oracle (III), phantom (IV)
   stealth/     policy, humanizer (mouse/keyboard/scroll/timing), gestures, fingerprint,
                session (store/warmup), ml (optionnel)
   recorder/    blueprint_recorder, gesture_recorder, capture, selector_synth
   builder/     construction headless de Blueprint (factory, catalog, templates)
-  console/     interface terminale globale (Textual) : Blueprint Studio, runs, catalogue,
-               sessions, settings — la porte d'entrée de l'outil
+  console/     interface terminale globale (Textual) : Blueprint Studio, runs, schedules,
+               catalogue, sessions, settings — la porte d'entrée de l'outil
+  notify/      canaux d'alerte natifs (webhook/discord/telegram/ntfy) + registre ouvert aux plugins
+  store/       état durable SQLite sous ~/.aetherius : schedules, historique des runs, état inter-run
+  plugins.py   découverte des extensions tierces par entry-points (actions + canaux)
   models/      registry + cache des assets ML runtime
-  server/      daemon FastAPI (routes/jobs/schemas)
+  server/      daemon FastAPI (routes/jobs/schemas) + scheduler (triggers/misfire/alerts)
+  cli/         commandes scriptables (run/validate/serve/record, groupe schedule)
   config/      settings
 contracts/     blueprint.schema.json, openapi.yaml, events.schema.json  (source de vérité)
+deploy/        recette always-on : Dockerfile, docker-compose.yml, service systemd
 sdks/          typescript (@aetherius/client), python
-examples/      Blueprints de démonstration
+examples/      Blueprints de démonstration (par Act + plugins/)
 training/      entraînement des modèles Oracle (hors runtime)
 legacy_examples/  code de référence des projets d'origine (UKit, TikTok) + carte de provenance
 ```
@@ -456,7 +462,8 @@ Conventions de contribution (discipline de test, invariants, structure des tests
 Le projet avance en deux grandes phases. La **Phase 1** — le socle, utilisable comme **bibliothèque**
 (in-process Python) et comme **service** (daemon + SDK) — est **terminée avec ce jalon** : un premier
 point de contrôle, à éprouver en conditions réelles avant d'attaquer la **Phase 2** (les deux Acts les
-plus lourds).
+plus lourds). Entre les deux, une **Phase 1.5** durcit ce socle pour les workflows **récurrents et
+réactifs** (planification, alertes, réactivité) — voir ci-dessous.
 
 ### Phase 1 — le socle réutilisable (terminée)
 
@@ -524,6 +531,81 @@ plus lourds).
 **Phase 1 terminée.** Aetherius est utilisable comme bibliothèque et comme service ; c'est le point de
 contrôle prévu pour l'éprouver en conditions réelles et corriger avant la suite.
 
+### Phase 1.5 — socle opérationnel (en cours)
+
+Un palier intermédiaire, dans l'esprit du durcissement du socle : rendre Aetherius capable de porter
+des workflows **récurrents et réactifs** (planifier un Blueprint, réagir aux données extraites,
+alerter au bon moment) avant les Acts autonomes. Le cas fil rouge : surveiller un produit en rupture,
+vérifier plusieurs fois par jour, alerter au retour en stock. Et, dans la même veine furtive que la
+couche stealth, le rendre invisible **au niveau réseau** (proxy, rotation d'IP). Cadrage complet et
+**spécifications par jalon** : [docs/phase-1.5/](docs/phase-1.5/README.md).
+
+- [x] **Persistance (`store/`)** : état durable SQLite (stdlib) sous `~/.aetherius` — schedules,
+  historique des runs, état inter-run. Fondation des autres jalons. Le daemon y persiste désormais
+  l'historique de ses runs. [docs/store.md](docs/store.md),
+  [docs/phase-1.5/a-store.md](docs/phase-1.5/a-store.md).
+- [x] **Réactivité et flux conditionnel** : garde d'étape `when` universelle (step sauté = statut
+  `skipped` + événement `step_skipped`) et actions `if`/`repeat`/`for_each` exécutées récursivement
+  par le moteur sur tous les Acts (validation récursive des branches, variable de boucle `as`,
+  rend la réutilisation de session Continuum exprimable). Exemples zéro config dans
+  `examples/vector/`. [docs/blueprint-schema.md](docs/blueprint-schema.md),
+  [docs/phase-1.5/b-flow.md](docs/phase-1.5/b-flow.md).
+- [x] **Notifications natives** : couche d'alerte sans dépendance nouvelle (webhook générique,
+  Discord, Telegram, **ntfy** pour la push téléphone — un POST `httpx` chacun), action `notify`
+  Act-agnostique (handler partagé, se combine à `when`) + `NotifySink` de fin de run
+  (`failure`/`success`/`always`), registre de canaux prêt pour les plugins (Jalon E), échec d'envoi
+  contenu (jamais fatal au run, `delivered` exposé). La dédup au changement d'état est désormais
+  portée par le scheduler (Jalon D, politique `change`). Exemple zéro config :
+  `examples/vector/books-restock-notify.blueprint.json`. [docs/notifications.md](docs/notifications.md),
+  [docs/phase-1.5/c-notifications.md](docs/phase-1.5/c-notifications.md).
+- [x] **Scheduler (daemon)** : rejeu persistant d'un Blueprint à heure fixe (cron, fuseau local,
+  DST gérés) ou par intervalle, plus le tir unique (`at`). Intégré au daemon (lifespan FastAPI,
+  tick 30 s) ; un run planifié passe par `RunManager.submit` — indiscernable d'un run manuel, avec
+  le lien `schedule_id` dans l'historique. CLI `aetherius schedule add|list|rm|pause|resume|run`
+  (écrit directement dans le store : marche daemon éteint) et API `/v1/schedules` (CRUD + tir
+  immédiat). Rattrapage des tirs manqués par politique `misfire` (`skip`/`run_once`/`run_all`) et
+  politique d'alerte par schedule (`failure`/`success`/`always`/`change` — dédup au changement
+  d'état via le store). **Écran Console dédié** : liste, pause/reprise, suppression, détail avec
+  historique et tir manuel (événements en direct), formulaire de création/édition guidé, raccourci
+  `s` depuis Library. Exemple zéro config : `examples/vector/quotes-watch.blueprint.json`.
+  [docs/scheduler.md](docs/scheduler.md),
+  [docs/phase-1.5/d-scheduler.md](docs/phase-1.5/d-scheduler.md).
+- [x] **Actions custom / plugins** : points d'extension activés — un paquet tiers ajoute des
+  **actions** et des **canaux de notification** sans forker le cœur. Découverte par entry-points
+  (`aetherius.actions`, `aetherius.notify_channels`) chargée au démarrage (CLI, daemon, moteur
+  in-process) ; une action plugin embarque sa spec (visible du Studio et du validator, act-agnostique,
+  dispatchée en repli après les built-ins) ; gardes de collision (les built-ins restent prioritaires)
+  et pannes isolées (un plugin cassé est loggé et sauté, jamais fatal au démarrage). Plugin d'exemple
+  exécutable : `examples/plugins/` (action `demo.slugify` + canal `logfile`).
+  [docs/plugins.md](docs/plugins.md), [docs/phase-1.5/e-plugins.md](docs/phase-1.5/e-plugins.md).
+- [x] **Déploiement always-on** : recette 24/7 vérifiée de bout en bout pour héberger le daemon sur
+  une machine allumée (VPS, Raspberry Pi, NAS) — la réponse honnête au « hors machine ». Deux voies
+  dans [`deploy/`](deploy/) : image Docker durcie (multi-stage, non-root, healthcheck, variante Act
+  II via `--build-arg BROWSER=1`) + `docker-compose.yml` (volume persistant unique `/data`, port
+  publié sur la loopback de l'hôte, Blueprints utilisateur montés) et service systemd utilisateur
+  (`enable-linger`, redémarrage automatique). Tout l'état durable (schedules, historique, profils)
+  vit sous `AETHERIUS_DATA_DIR` et survit aux redémarrages ; sécurité par défaut : loopback, et
+  exposer exige token + reverse proxy TLS. [docs/deployment.md](docs/deployment.md),
+  [docs/phase-1.5/f-deployment.md](docs/phase-1.5/f-deployment.md).
+- [x] **Identité réseau** : option `options.proxy` de premier niveau atteignant les **deux** moteurs
+  (Vector httpx/curl_cffi, Continuum Playwright ; HTTP/HTTPS/SOCKS5). Rotation de l'IP par run
+  (`per_run`/`round_robin`/`random`/`sticky`, pool inline ou défaut d'environnement `AETHERIUS_PROXY_*`),
+  prévention de la fuite WebRTC (flag de lancement + init-script, liée au proxy), cohérence géo
+  (timezone/locale/langues alignés sur le pays de l'IP, écrasant le profil d'empreinte) et
+  impersonation TLS (JA3/JA4) pour Vector via l'extra `[network]`. Identifiants jamais stockés
+  (`{{ secrets.x }}`). Exemple : `examples/vector/ip-echo-proxy.blueprint.json` (nécessite un proxy).
+  [docs/network.md](docs/network.md), [docs/phase-1.5/g-network.md](docs/phase-1.5/g-network.md).
+- [x] **Durcissement de l'empreinte** : les signaux restants sont fermés **de façon cohérente avec le
+  profil** — Canvas et AudioContext (bruit déterministe par profil, stable entre deux lectures),
+  énumération des polices (`measureText`), client hints (`Sec-CH-UA` / `navigator.userAgentData`
+  dérivés de l'UA du profil, la limite « UA-CH drift » est levée), dimensions d'écran /
+  `devicePixelRatio` et WebGL2. Vector (Act I) gagne une **identité d'en-têtes par défaut** (UA +
+  client hints + `Accept-Language` alignés) quand `options.stealth` nomme un profil, sans écraser les
+  en-têtes explicites du Blueprint ni rien changer aux runs sans stealth. Exemples zéro config :
+  `examples/continuum/fingerprint-hardening.blueprint.json` et
+  `examples/vector/http-headers-identity.blueprint.json`. [docs/stealth.md](docs/stealth.md),
+  [docs/phase-1.5/h-fingerprint.md](docs/phase-1.5/h-fingerprint.md).
+
 ### Phase 2 — les Acts autonomes (à venir)
 
 - [ ] Act III — Oracle (vision + entraînement).