newskit 0.1.7__tar.gz

newskit-0.1.7/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.py[cod]
+.venv/
+.ruff_cache/
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+build/
+dist/
+*.egg-info/
+.DS_Store
+# Les données d'un média ne vivent jamais dans le dépôt du moteur.
+/cache/
+/graphe/
+/sources/
+/config.yaml
+/sources.yaml
+/EXTRAIT.json
+/dist/

newskit-0.1.7/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Journal des versions
+
+Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/) ; les versions suivent [SemVer](https://semver.org/lang/fr/).
+
+## [Non publié]
+
+## [0.1.7] - 2026-11-07
+
+### Modifié
+
+- Newskit est publié sur PyPI : `pip install newskit`. Publication par Trusted Publishing à chaque tag, répétition sur TestPyPI (`testpypi.yml`). Description du paquet en anglais ; liens du README absolus, pour la page PyPI.
+- Format du code vérifié en CI et au pre-push (`ruff format --check`) ; modèles d'issue et de PR en anglais ; Discussions.
+
+## [0.1.6] - 2026-11-07
+
+### Modifié
+
+- Le mot « nuit » devient « passage » dans le skill, l'aide et les messages ; `newskit temoin passage`, `nuit` restant accepté.
+- `media.passages: {tous_les, heures}` remplace `media.frequence` : plusieurs passages par jour, ou un tous les N jours. La tâche planifiée part à chaque heure avec `--planifie` ; un jour hors de l'intervalle, la routine s'arrête avant le témoin. `frequence` reste lue.
+- Les commandes en anglais : `run`, `new-graph`, `query … search`, `costs --by`, `test`, avec leurs options (`--graph`, `--check`, `--label`, `--domain`, `--subjects`, `--since`, `--limit`, `--no-commit`, `--no-email`…). Les noms français restent acceptés.
+- README en anglais (`README.md`) et en français (`README.fr.md`) : comment le graphe grandit, la répétition expliquée, les outils qui l'étendent. Descriptions du plugin en anglais.
+
+## [0.1.5] - 2026-11-07
+
+### Corrigé
+
+- Couche 2 : un appel au modèle ne part plus avant que le résultat précédent soit écrit. Une étape tuée perdait des réponses payées, qui étaient repayées au passage suivant.
+
+## [0.1.4] - 2026-11-07
+
+### Modifié
+
+- Le registre des graphes (libellés, résumés, sujets déclarés, que les thèmes émergents réécrivent chaque nuit) vit dans le dossier du média, `graphes.json` ; la clé `registre_des_graphes` de `config.yaml` le place ailleurs. Il était fixé au registre d'un skill de la première édition.
+
+## [0.1.3] - 2026-11-07
+
+### Modifié
+
+- `newskit nouveau-graphe` écrit une tâche planifiée qui lance le moteur installé (`-m newskit.routine_hebdo`) sur le dossier du média, avec l'interpréteur qui porte le paquet ; sans installateur des daemons, elle est prête à poser sous `taches/`. Les pièces des installateurs ne sont demandées qu'au média qui les porte.
+- La consigne de traduction des libellés nomme le graphe traduit (son libellé), plus un thème fixe.
+- La métadonnée d'identifiant des entités versées dans CortexDB s'appelle `newskit_id` ; l'empreinte d'un versement la lit sous son ancien nom, si bien qu'aucun cerveau n'est reversé en entier. Le relevé des lacunes se présente au gateway comme `newskit-releve`.
+
+### Ajouté
+
+- L'icône du plugin.
+
+## [0.1.2] - 2026-11-07
+
+### Corrigé
+
+- Un article, une fiche, une langue : la collecte n'écrit plus une seconde fiche pour la version d'un article dans une autre langue. Le contrôle des doublons d'identité nomme les fiches d'un même document.
+
+## [0.1.1] - 2026-11-07
+
+### Corrigé
+
+- pytest s'installe avec le paquet : le témoin, sans lequel aucune nuit ne part, tombait sur « No module named pytest » après un `pip install` simple. L'extra `temoin` disparaît.
+- Le vocabulaire anglais est livré avec le moteur (web2) : sous Linux, sans liste de mots du système, le tri des libellés à traduire changeait.
+
+## [0.1.0] - 2026-11-07
+
+Première version, sortie du dépôt de l'édition où le moteur est né.
+
+### Ajouté
+
+- Le paquet `newskit` et la commande `newskit` : un module du moteur par sous-commande (`newskit routine`, `newskit nouveau-graphe`, `newskit graphe`, `newskit media`, `newskit temoin`, `newskit couts`).
+- Le dossier du média : un `config.yaml` (identité, langue, traductions, heure de la nuit, un modèle par rôle, fichier des sources, module de diffusion, graphes), lu depuis `NEWSKIT_DONNEES` ou le dossier courant.
+- Le témoin : une nuit entière sur un graphe sans rapport, rejouée de réponses enregistrées, sans appel payant (`newskit temoin nuit`) ; une nuit ne part pas sans un témoin vert du jour.
+- Le plugin de Claude Code : le skill `newskit` (formulaire du média, sources et thèmes de départ, naissance, nuit, interrogation) et un crochet qui refuse les appels au modèle quand la fenêtre d'usage est fermée.
+
+[Non publié]: https://github.com/lfoletti/newskit/compare/v0.1.7...HEAD
+[0.1.7]: https://github.com/lfoletti/newskit/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/lfoletti/newskit/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/lfoletti/newskit/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/lfoletti/newskit/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/lfoletti/newskit/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/lfoletti/newskit/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/lfoletti/newskit/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/lfoletti/newskit/releases/tag/v0.1.0

newskit-0.1.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lauro Foletti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

newskit-0.1.7/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.5
+Name: newskit
+Version: 0.1.7
+Summary: Automated topic monitoring for Claude Code: collects your sources, writes one cited note per item and keeps a knowledge graph up to date.
+Project-URL: Source, https://github.com/lfoletti/newskit
+Project-URL: Issues, https://github.com/lfoletti/newskit/issues
+Project-URL: Changelog, https://github.com/lfoletti/newskit/blob/main/CHANGELOG.md
+Author: Les mainteneurs de Newskit
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude-code,knowledge-graph,monitoring,news,newsletter,rag
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: French
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.12
+Requires-Dist: graphifyy>=0.9
+Requires-Dist: lxml>=5.0
+Requires-Dist: networkx>=3.2
+Requires-Dist: numpy>=1.26
+Requires-Dist: pypdf>=4.0
+Requires-Dist: pytest>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: trafilatura>=1.12
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Provides-Extra: encodeur
+Requires-Dist: fastembed>=0.3; extra == 'encodeur'
+Requires-Dist: onnxruntime>=1.17; extra == 'encodeur'
+Requires-Dist: sentence-transformers>=3.0; extra == 'encodeur'
+Requires-Dist: tokenizers>=0.19; extra == 'encodeur'
+Requires-Dist: torch>=2.2; extra == 'encodeur'
+Requires-Dist: transformers>=4.40; extra == 'encodeur'
+Description-Content-Type: text/markdown
+
+# Newskit
+
+[![ci](https://github.com/lfoletti/newskit/actions/workflows/ci.yml/badge.svg)](https://github.com/lfoletti/newskit/actions/workflows/ci.yml)
+[![licence MIT](https://img.shields.io/badge/licence-MIT-blue.svg)](https://github.com/lfoletti/newskit/blob/main/LICENSE)
+[![version](https://img.shields.io/github/v/tag/lfoletti/newskit?label=version)](https://github.com/lfoletti/newskit/blob/main/CHANGELOG.md)
+
+English | [Français](https://github.com/lfoletti/newskit/blob/main/README.fr.md)
+
+Automated topic monitoring for Claude Code. You name a subject and give a few sources; at regular intervals Newskit collects them, writes one note per item, extracts the concepts and how they relate, and keeps a knowledge graph up to date, within a spending cap. Two things set it apart from a feed reader: every answer drawn from the graph cites its note and its line, and the graph extends itself to new themes and new sources.
+
+For developers who already use Claude Code: every model call goes through `claude -p`, under your own Claude subscription. Notes, feed and newsletter are written in French; an English translation can be added (`traductions: [en]`).
+
+[![governance.news, an AI governance media built on Newskit](https://raw.githubusercontent.com/lfoletti/newskit/main/docs/governance-news-en.png)](https://governance.news/en/)
+
+*[governance.news](https://governance.news/en/): a newsletter and a knowledge graph on AI governance in business, built on Newskit.*
+
+## What you get
+
+All of it lives in your media folder, as plain files:
+
+- **Notes**: one Markdown file per collected item, under `sources/`, with its title, author, date and address.
+- **The graph**: `graphe/<name>/graphe.json`, its map (`carte.md`, the main themes and their concepts) and the report of each pass (`ROUTINE.md`).
+- **Answers with their source**: `newskit query` searches the graph without any model call and gives, for each answer, the note and the line that support it.
+- **A feed and a newsletter**: short posts on the latest items (`fil.json`) and a newsletter of the graph, sent through your own delivery module (`diffusion:` in `config.yaml`).
+
+```text
+$ newskit query --graph ai-governance sources "general-purpose AI model"
+  Sources attestant « General-purpose AI models »
+    sources/ai_compliance/rss/ec_digital/2026-08-02_navigating-ai-act.md L211
+```
+
+## Quick start
+
+You need Python 3.12 or later, git, macOS or Linux, and a logged-in Claude Code (`claude`).
+
+The words used below: the **media** is your project folder; it holds one or more **graphs**; each graph follows **subjects**; a **pass** collects the graph's sources and writes one **note** per item.
+
+1. Install the engine and test it in an empty folder:
+
+   ```sh
+   pip install newskit
+   mkdir my-media && cd my-media
+   newskit test
+   ```
+
+   The test runs one full pass on a sample graph (medieval beekeeping), with model answers replayed from a recording: no paid call, about one minute. It must end with « témoin vert » (test passed).
+
+2. Open Claude Code in that folder (`claude`) and install the plugin:
+
+   ```text
+   /plugin marketplace add lfoletti/newskit
+   /plugin install newskit@newskit
+   ```
+
+3. Ask Claude to follow a subject: “start a monitoring graph on urban gardening”. The `newskit` skill asks its questions, writes `config.yaml` and `sources.yaml`, suggests themes drawn from the sources you give, creates the graph and runs a first pass in front of you.
+
+4. Read the result: `graphe/<name>/ROUTINE.md` for the report, `newskit query --graph <name> search "…"` for the graph.
+
+5. Schedule the next passes. `newskit new-graph` has written the graph's task under `taches/` and printed the two `sudo` lines that install it in launchd (macOS). On Linux, add a cron line at each time of `passages` that runs `newskit test` then `newskit run --graph <name> --scheduled`; on a day outside the interval, the scheduled run stops by itself.
+
+## Sources
+
+Sources are declared in `sources.yaml`, next to `config.yaml`, one block per source, each tied to a graph. Supported: RSS feeds, sitemaps and listing pages (for sites without a feed), Substack, Medium, LinkedIn newsletters, arXiv, journals by ISSN, OpenAlex, GitHub and Hugging Face searches, an e-mail inbox, and local folders of Markdown or PDF files.
+
+```yaml
+version: 1
+sources:
+  - cle: city_farmer
+    plateforme: Flux RSS
+    nom: City Farmer News
+    dossier: potagers/rss
+    abonnement: gratuit
+    graphe: potagers-urbains
+    flux: https://cityfarmer.info/feed/
+  - cle: soil_papers
+    plateforme: OpenAlex
+    nom: OpenAlex, urban soil
+    dossier: potagers/openalex
+    abonnement: gratuit
+    graphe: potagers-urbains
+    requetes: ["urban allotment soil contamination"]
+```
+
+The skill writes this file for you from the addresses you give; a source the engine cannot read is refused with its reason.
+
+## How the graph grows
+
+The graph does not stay within the subjects you declared at the start: it expands.
+
+- **New themes.** After each pass, the engine looks for clusters of concepts that none of the declared subjects covers. A candidate that comes back three passes in a row joins the subjects; the sources and searches follow it.
+- **Auto-completion.** A question the graph could not answer becomes a search for the next pass. A web scout searches the declared subjects; a question agent probes the graph the way a practitioner would; what a language model considers essential and the graph lacks becomes a shopping list of sources to find.
+- **The source list.** The engine assesses a candidate domain before it is declared, and keeps track of every source a user drops in (a link sent from the browser). A source that keeps failing is audited and, when a route exists, repaired on its own (see accesspath below).
+- **Clean concepts.** The same concept found under several labels (a translation, an acronym, a variant) is merged after a model confirms it is exactly the same concept; refusals are kept and never asked again.
+
+## The media folder
+
+The media is a folder that holds a `config.yaml`. The engine attaches to it: the `NEWSKIT_DONNEES` variable first, otherwise the current folder. The code stays in the installed package; the data (notes, graph, cost ledger) live in the media folder.
+
+```yaml
+version: 1
+media:
+  nom: potagers               # name: lowercase, digits and hyphens
+  langue: fr                  # language of the prompts and of the publication
+  traductions: [en]           # translated feed and newsletter; none by default
+  passages: {tous_les: 1, heures: ["05:30"]}   # every N days, at these times
+modeles:                      # one model per role; a missing role keeps its default
+  extraction: claude-opus-5-5
+  redaction: claude-sonnet-5-5
+sources: sources.yaml         # the source list, kept apart
+# registre_des_graphes: graphes.json   # labels and declared subjects, kept by the engine (default)
+graphes:
+  potagers-urbains:
+    libelle: Potagers urbains   # label
+    domaine: "urban gardening: allotments, soil, seed exchange"   # the domain, in English, for extraction
+```
+
+`newskit media` shows what was read; an unknown field is refused and named. The roles: `extraction` (reading a note and drawing its concepts), `analyse` (judging a whole graph), `redaction` (summaries and newsletter), `lecture` (deciding whether two labels are the same concept), `traduction` (translation), `questions` (training questions for the local encoder).
+
+## Cost
+
+Every model call goes through your subscription and counts against its usage limits; the cost ledger records each one at its API-equivalent price, so you can see where the usage goes (`newskit costs --by graph`). Concept extraction is the main item: measured on governance.news, about $0.25 per note with the default model (Opus), so about $10 per pass at the default cap of 40 notes. The cap is set per graph (`--cap` of `newskit new-graph`).
+
+## Commands
+
+| Command | What it does |
+| :- | :- |
+| `newskit` | the commands, one line each |
+| `newskit media` | the media as read: language, translations, passages, model per role |
+| `newskit new-graph <name>` | creates a graph, or says what it lacks (`--check`) |
+| `newskit run --graph <name>` | one pass: collection, notes, concept extraction within the cap, graph |
+| `newskit query --graph <name> search "…"` | queries the graph, no model call; each answer carries its provenance |
+| `newskit costs --by graph` | spending over the last seven days |
+| `newskit test` | tries the engine on a sample graph, at no cost; a real pass starts only after a successful test the same day |
+
+## Safeguards
+
+- **The test.** Before the real pass, the engine runs `newskit test` on the sample graph with recorded answers. The real pass starts only if a test passed the same day with the same engine version. An engine update therefore cannot break a pass unnoticed: it stops before spending anything.
+- **The caps.** Each step has its own cap on notes and on spending; every model call is written to the cost ledger, under a step and a graph.
+- **The usage limit.** After three usage limits in a row, the engine sets a marker that lasts three hours. The plugin's hook then refuses any model call started from Claude Code.
+
+## Works with
+
+Newskit relies on:
+
+- **[graphify](https://github.com/Graphify-Labs/graphify)**, installed with the package. Reads the structure of the documents, validates each extraction against the schema, builds the graph and splits it into communities.
+- **[trafilatura](https://trafilatura.readthedocs.io)**, installed with the package. Main text extraction from web pages.
+- **[pytest](https://pytest.org)**, installed with the package: `newskit test` runs on it.
+
+The following tools extend its features when they are installed:
+
+- **[accesspath](https://github.com/lfoletti/accesspath)** (sap). Website access audit. When a source keeps failing, Newskit asks sap which route still reaches it (RSS feed, API, sitemap, plain HTML, browser) and repairs the source.
+- **[cortexdb](https://github.com/lfoletti/cortexdb)**. AI memory and knowledge graph in one SQLite file. A graph can be loaded into a cortexdb brain, each relation tied to the passage that supports it, and queried from any MCP client.
+- **[thalamus](https://github.com/lfoletti/thalamus)**. A governance layer over cortexdb for an organisation's shared knowledge. Questions left unanswered by its clients return to the engine as searches.
+
+## Limits of version 0.1
+
+- The prompts to the models are written in French; the only translation is English.
+- macOS and Linux. Scheduled passes run through launchd on macOS; on Linux, through a cron line.
+- `newskit new-graph` writes the graph's scheduled task under `taches/`, ready to install in `/Library/LaunchDaemons`.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/lfoletti/newskit/blob/main/CONTRIBUTING.md). Report a vulnerability privately: [SECURITY.md](https://github.com/lfoletti/newskit/blob/main/SECURITY.md).
+
+## Licence
+
+[MIT](https://github.com/lfoletti/newskit/blob/main/LICENSE).

newskit-0.1.7/README.fr.md

@@ -0,0 +1,167 @@
+# Newskit
+
+[![ci](https://github.com/lfoletti/newskit/actions/workflows/ci.yml/badge.svg)](https://github.com/lfoletti/newskit/actions/workflows/ci.yml)
+[![licence MIT](https://img.shields.io/badge/licence-MIT-blue.svg)](https://github.com/lfoletti/newskit/blob/main/LICENSE)
+[![version](https://img.shields.io/github/v/tag/lfoletti/newskit?label=version)](https://github.com/lfoletti/newskit/blob/main/CHANGELOG.md)
+
+[English](https://github.com/lfoletti/newskit/blob/main/README.md) | Français
+
+Une veille automatique pour Claude Code. Vous nommez un sujet et donnez quelques sources ; à intervalles réguliers, Newskit les collecte, écrit une fiche par article, en extrait les notions et leurs relations et tient à jour un graphe de connaissances, sous plafond de dépense. Deux choses le distinguent d'un lecteur de flux : chaque réponse tirée du graphe cite sa fiche et sa ligne ; le graphe s'étend de lui-même à des thèmes et à des sources nouveaux.
+
+Pour des développeurs qui ont déjà Claude Code : chaque appel au modèle passe par `claude -p`, sous votre abonnement Claude. Les fiches, le fil et la lettre s'écrivent en français ; une traduction anglaise peut s'y ajouter (`traductions: [en]`).
+
+[![governance.news, un média sur la gouvernance de l'IA bâti sur Newskit](https://raw.githubusercontent.com/lfoletti/newskit/main/docs/governance-news-fr.png)](https://governance.news/)
+
+*[governance.news](https://governance.news/) : un bulletin et un graphe de connaissances sur la gouvernance de l'IA en entreprise, bâtis sur Newskit.*
+
+## Ce que vous obtenez
+
+Tout vit dans le dossier du média, en fichiers ordinaires :
+
+- **Des fiches** : un fichier Markdown par article collecté, sous `sources/`, avec son titre, son auteur, sa date et son adresse.
+- **Le graphe** : `graphe/<nom>/graphe.json`, sa carte (`carte.md`, les grands thèmes et leurs notions) et le bilan de chaque passage (`ROUTINE.md`).
+- **Des réponses sourcées** : `newskit query` cherche dans le graphe sans appel au modèle et donne, pour chaque réponse, la fiche et la ligne qui l'attestent.
+- **Un fil et une lettre** : des billets courts sur les derniers articles (`fil.json`) et une lettre du graphe, envoyée par votre propre module de diffusion (`diffusion:` dans `config.yaml`).
+
+```text
+$ newskit query --graph ai-governance sources "general-purpose AI model"
+  Sources attestant « General-purpose AI models »
+    sources/ai_compliance/rss/ec_digital/2026-08-02_navigating-ai-act.md L211
+```
+
+## Démarrage rapide
+
+Il faut Python 3.12 ou plus récent, git, macOS ou Linux et Claude Code (`claude`) connecté.
+
+Les mots employés plus bas : le **média** est le dossier du projet ; il porte un ou plusieurs **graphes** ; chaque graphe suit des **sujets** ; un **passage** collecte les sources du graphe et écrit une **fiche** par article.
+
+1. Installer le moteur et l'essayer dans un dossier vide :
+
+   ```sh
+   pip install newskit
+   mkdir mon-media && cd mon-media
+   newskit test
+   ```
+
+   L'essai fait faire au moteur un passage entier sur un graphe d'exemple (l'apiculture médiévale), avec des réponses du modèle rejouées d'un enregistrement : aucun appel payant, une minute environ. Il doit finir par « témoin vert » (essai réussi).
+
+2. Ouvrir Claude Code dans ce dossier (`claude`) et installer le plugin :
+
+   ```text
+   /plugin marketplace add lfoletti/newskit
+   /plugin install newskit@newskit
+   ```
+
+3. Demander à Claude de suivre un sujet : « fais naître un graphe de veille sur les potagers urbains ». Le skill `newskit` pose ses questions, écrit `config.yaml` et `sources.yaml`, propose des thèmes tirés des sources que vous donnez, fait naître le graphe et lance un premier passage sous vos yeux.
+
+4. Lire le résultat : `graphe/<nom>/ROUTINE.md` pour le bilan, `newskit query --graph <nom> search "…"` pour le graphe.
+
+5. Planifier les passages suivants. `newskit new-graph` a écrit la tâche du graphe sous `taches/` et imprimé les deux lignes `sudo` qui la posent dans launchd (macOS). Sous Linux, ajouter une ligne de cron à chaque heure de `passages`, qui lance `newskit test` puis `newskit run --graph <nom> --scheduled` ; un jour hors de l'intervalle, le passage planifié s'arrête de lui-même.
+
+## Les sources
+
+Les sources se déclarent dans `sources.yaml`, à côté de `config.yaml`, un bloc par source, chacune rattachée à un graphe. Pris en charge : flux RSS, plans de site et pages de liste (pour les sites sans flux), Substack, Medium, lettres LinkedIn, arXiv, revues par ISSN, OpenAlex, recherches GitHub et Hugging Face, une boîte de courriel, des dossiers locaux de fichiers Markdown ou PDF.
+
+```yaml
+version: 1
+sources:
+  - cle: city_farmer
+    plateforme: Flux RSS
+    nom: City Farmer News
+    dossier: potagers/rss
+    abonnement: gratuit
+    graphe: potagers-urbains
+    flux: https://cityfarmer.info/feed/
+  - cle: soil_papers
+    plateforme: OpenAlex
+    nom: OpenAlex, urban soil
+    dossier: potagers/openalex
+    abonnement: gratuit
+    graphe: potagers-urbains
+    requetes: ["urban allotment soil contamination"]
+```
+
+Le skill écrit ce fichier pour vous à partir des adresses que vous donnez ; une source que le moteur ne sait pas lire est refusée avec sa raison.
+
+## Comment le graphe grandit
+
+Le graphe ne reste pas dans les sujets déclarés au départ : il s'étend.
+
+- **Thèmes nouveaux.** Après chaque passage, le moteur cherche les groupes de notions qu'aucun sujet déclaré ne couvre. Un candidat qui revient trois passages de suite entre parmi les sujets ; les sources et les recherches le suivent.
+- **Auto-complétion.** Une question à laquelle le graphe n'a pas su répondre devient une recherche du passage suivant. Un éclaireur cherche sur le web autour des sujets déclarés ; un poseur de questions interroge le graphe comme le ferait un praticien ; ce qu'un modèle de langage tient pour essentiel et que le graphe n'a pas devient une liste de sources à trouver.
+- **La liste des sources.** Le moteur étudie un domaine candidat avant de le déclarer et garde la mémoire de chaque source qu'un lecteur dépose (un lien envoyé depuis le navigateur). Une source qui échoue plusieurs fois est auditée et, quand une voie existe, réparée d'elle-même (voir accesspath plus bas).
+- **Des notions nettes.** La même notion sous plusieurs libellés (traduction, sigle, variante) est fondue après qu'un modèle a confirmé qu'il s'agit exactement de la même ; les refus sont gardés et jamais redemandés.
+
+## Le dossier du média
+
+Le média est un dossier qui porte un `config.yaml`. Le moteur s'y accroche : la variable `NEWSKIT_DONNEES` d'abord, sinon le dossier courant. Le code reste dans le paquet installé ; les données (fiches, graphe, registre des coûts) vivent dans le dossier du média.
+
+```yaml
+version: 1
+media:
+  nom: potagers               # le nom : minuscules, chiffres et tirets
+  langue: fr                  # la langue des consignes et de la publication
+  traductions: [en]           # fil et lettre traduits ; aucune par défaut
+  passages: {tous_les: 1, heures: ["05:30"]}   # tous les N jours, à ces heures
+modeles:                      # un modèle par rôle ; un rôle absent garde son défaut
+  extraction: claude-opus-5-5
+  redaction: claude-sonnet-5-5
+sources: sources.yaml         # le fichier des sources, à part
+# registre_des_graphes: graphes.json   # libellés et sujets déclarés, tenus par le moteur (défaut)
+graphes:
+  potagers-urbains:
+    libelle: Potagers urbains   # le libellé
+    domaine: "urban gardening: allotments, soil, seed exchange"   # le domaine, en anglais, pour l'extraction
+```
+
+`newskit media` dit ce qui est lu ; un champ inconnu est refusé et nommé. Les rôles : `extraction` (lire une fiche et en tirer les notions), `analyse` (juger un graphe entier), `redaction` (synthèses et lettre), `lecture` (trancher si deux libellés sont la même notion), `traduction`, `questions` (questions d'entraînement de l'encodeur local).
+
+## Le coût
+
+Chaque appel au modèle passe par votre abonnement et compte dans ses limites d'usage ; le registre des coûts inscrit chacun à son prix d'API, pour voir où va l'usage (`newskit costs --by graph`). L'extraction des notions est le poste principal : mesurée sur governance.news, environ 0,25 $ par fiche avec le modèle par défaut (Opus), soit environ 10 $ par passage au plafond par défaut de 40 fiches. Le plafond se règle par graphe (`--cap` de `newskit new-graph`).
+
+## Les commandes
+
+| Commande | Ce qu'elle fait |
+| :- | :- |
+| `newskit` | les commandes, une ligne chacune |
+| `newskit media` | le média lu : langue, traductions, passages, modèle par rôle |
+| `newskit new-graph <name>` | fait naître un graphe, ou dit ce qui lui manque (`--check`) |
+| `newskit run --graph <name>` | un passage : collecte, fiches, extraction des notions sous plafond, graphe |
+| `newskit query --graph <name> search "…"` | interroge le graphe, sans appel au modèle ; chaque réponse porte sa provenance |
+| `newskit costs --by graph` | la dépense des sept derniers jours |
+| `newskit test` | essaie le moteur sur un graphe d'exemple, sans frais ; un vrai passage ne part qu'après un essai réussi le même jour |
+
+## Les gardes
+
+- **L'essai.** Avant le vrai passage, le moteur lance `newskit test` sur le graphe d'exemple, avec des réponses enregistrées. Le vrai passage ne part que si un essai a réussi le même jour avec la même version du moteur. Une mise à jour du moteur ne peut donc pas casser un passage sans qu'on le voie : il s'arrête avant de rien dépenser.
+- **Les plafonds.** Chaque étape a son plafond de fiches et de dépense ; chaque appel au modèle entre au registre des coûts, sous une étape et un graphe.
+- **La limite d'usage.** Après trois limites d'affilée, le moteur pose une marque qui vaut trois heures. Le crochet du plugin refuse alors tout appel au modèle lancé depuis Claude Code.
+
+## Avec d'autres outils
+
+Newskit s'appuie sur :
+
+- **[graphify](https://github.com/Graphify-Labs/graphify)**, installé avec le paquet. Lit la structure des documents, valide chaque extraction contre le schéma, compose le graphe et le découpe en communautés.
+- **[trafilatura](https://trafilatura.readthedocs.io)**, installé avec le paquet. Extraction du texte principal des pages web.
+- **[pytest](https://pytest.org)**, installé avec le paquet : `newskit test` tourne dessus.
+
+Les outils suivants en étendent les fonctionnalités quand ils sont installés :
+
+- **[accesspath](https://github.com/lfoletti/accesspath)** (sap). Audit d'accès aux sites web. Quand une source échoue plusieurs fois, Newskit demande à sap quelle voie l'atteint encore (flux RSS, API, plan du site, HTML simple, navigateur) et répare la source.
+- **[cortexdb](https://github.com/lfoletti/cortexdb)**. Mémoire d'IA et graphe de connaissances dans un seul fichier SQLite. Un graphe peut être versé dans un cerveau cortexdb, chaque relation rattachée au passage qui la soutient, puis interrogé depuis tout client MCP.
+- **[thalamus](https://github.com/lfoletti/thalamus)**. Une couche de gouvernance sur cortexdb pour le savoir partagé d'une organisation. Les questions restées sans réponse chez ses clients reviennent au moteur comme recherches.
+
+## Limites de la version 0.1
+
+- Les consignes aux modèles sont écrites en français ; la seule traduction est l'anglais.
+- macOS et Linux. Les passages planifiés passent par launchd sur macOS ; sous Linux, par une ligne de cron.
+- `newskit new-graph` écrit la tâche planifiée du graphe sous `taches/`, prête à poser dans `/Library/LaunchDaemons`.
+
+## Contribuer
+
+Voir [CONTRIBUTING.md](https://github.com/lfoletti/newskit/blob/main/CONTRIBUTING.md). Une faille se signale en privé : [SECURITY.md](https://github.com/lfoletti/newskit/blob/main/SECURITY.md).
+
+## Licence
+
+[MIT](https://github.com/lfoletti/newskit/blob/main/LICENSE).