YUCLAW  v5.1

Guide de l'utilisateur — Evidence-First Financial AI. Chaque signal remonte à un dépôt réglementaire réel auprès de la SEC.
Un laboratoire de recherche ouvert où les hypothèses de marché sont testées, contestées et conservées — chaque conclusion portant sa propre piste d'audit.
L'équipe YUCLAW · Août 2026 · yuclaw.ca · github.com/YuClawLab/yuclaw-brain · pip install yuclaw · Licence Apache-2.0 · Édition française
Avertissement. YUCLAW est une plateforme de recherche et d'éducation. Rien dans ce guide ni sur aucune surface YUCLAW ne constitue un conseil en investissement, une recommandation ou une offre de produit. Les libellés de signaux sont des classifications de recherche, pas des recommandations d'achat ou de vente. Les résultats passés — en échantillon comme en suivi prospectif — ne préjugent pas des performances futures. Implication d'investissement : aucune n'est établie — aucune conclusion d'achat, de vente ou d'alpha n'est étayée par ce document.
Pourquoi YUCLAW existe

Les marchés financiers produisent chaque jour des millions d'affirmations — titres de presse, notes, scores, prédictions. Presque aucune ne peut être vérifiée. L'affirmation arrive ; les éléments qui la fondent, les hypothèses, l'historique des affirmations semblables et la liste de ce qui a été tenté sans succès — tout cela reste caché. Une affirmation sans fondement vérifiable devient du bruit, et le bruit assuré de lui-même devient dangereux.

YUCLAW repose sur un refus simple : ne jamais publier un chiffre qu'un inconnu ne peut pas recalculer. Chaque signal remonte à un dépôt réglementaire réel. Chaque statistique porte son protocole, l'anatomie de son échantillon et le décompte de tout ce qui a été essayé par ailleurs. Chaque hypothèse abandonnée reste au dossier, car savoir ce qui ne fonctionne pas est la moitié de tout savoir.

Le produit n'est pas une prédiction. Le produit est un dossier que vous pouvez contrôler — et un ensemble d'instruments qui le contrôlent avant vous.

Sommaire

1 · Ce qu'est YUCLAW (et ce qu'il n'est pas)6 · Lire les statistiques honnêtement
2 · Démarrage en trois minutes7 · Tout vérifier par vous-même
3 · Plan du site8 · Les moteurs de recherche, en langage clair
4 · Libellés de signaux et seuils publiés9 · Le registre de protocoles et le pré-enregistrement
5 · Référence de la ligne de commande10 · Dossiers de preuves, exports & couche IA
11 · Apportez votre propre signal (service de recherche)13 · État des lieux : établi et non établi
12 · Limites connues14 · FAQ  ·  15 · Glossaire  ·  16 · Citer YUCLAW

1 · Ce qu'est YUCLAW (et ce qu'il n'est pas)

YUCLAW ingère des dépôts réglementaires réels de la SEC (8-K, 10-K, Form 4, ainsi que la filière des émetteurs privés étrangers : 6-K, 20-F, 40-F), en extrait des événements typés à l'aide de modèles de langage hébergés localement, les classe sous un vocabulaire public figé, et étudie si ce flux d'éléments porte de l'information — en publiant chaque résultat exactement tel que mesuré, y compris lorsqu'il contredit l'hypothèse. Toute l'inférence tourne sur du matériel local ; le pipeline complet, les dérivations de données et la méthodologie sont en source ouverte sous licence Apache-2.0.

Trois engagements de conception définissent la plateforme :

Ce que YUCLAW n'est pas : ni sélectionneur d'actions, ni système de trading, ni service de conseil, ni produit de performance. Il ne publie jamais de recommandation de vente ni de vente à découvert. Si vous cherchez quelque chose qui vous dise quoi acheter, ce n'est pas le bon outil — délibérément.

1.1 · Vue d'ensemble

Les dépôts deviennent des événements cités ; les événements alimentent soit l'univers noté (79 valeurs), soit le niveau « éléments seulement », jamais noté ; toute la recherche s'exécute sous protocoles pré-enregistrés ; des barrières se dressent entre chaque résultat et le dossier public ; et la boucle en pointillés est l'essentiel — le dossier public alimente une vérification indépendante qui remonte jusqu'à la source. (Schéma d'architecture : voir l'édition anglaise, §1.1 — identique.)

2 · Démarrage en trois minutes

pip install yuclaw
yuclaw demo          # visite guidée de 3 minutes — fonctionne partout, aucune configuration
yuclaw replay-lab    # reproduit les statistiques publiées du Lab depuis le paquet public
yuclaw verify AMD --date 2026-05-20   # contrôle un signal contre le registre public

Toutes les commandes de la famille lecture/vérification fonctionnent depuis n'importe quel ordinateur connecté — elles ne consomment que le paquet public publié. Les commandes qui lisent le backend de recherche (events, lens, memo, export) nécessitent un nœud de recherche YUCLAW ; sur toute autre machine, elles affichent une explication claire d'un paragraphe et sortent avec le code 3 — jamais une trace d'erreur brute.

Premier geste utile : lancez yuclaw replay-lab. La commande recalcule chaque statistique et chaque racine du registre quotidien à partir des données publiées. Un code de sortie 0 signifie que votre machine vient de reproduire le site. Cette seule commande résume la thèse de la plateforme.

3 · Plan du site (yuclaw.ca)

PageLa question à laquelle elle répond
AccueilClassifications de recherche actuelles pour l'univers noté de 79 valeurs, avec scores composites. Légende du tableau : classifications de recherche — pas des recommandations.
Validation LabLe signal composite contient-il une information prospective mesurable ? Déciles, coefficients d'information, intervalles de confiance en grappes, comparaisons de référence, calibration, IC neutralisés — les résultats négatifs et non concluants affichés tels que mesurés.
SMH Covered-Constituent Evidence LensÉtude d'événements sur la part du poids divulgué de SMH couverte par YUCLAW (pourcentage affiché dynamiquement). Explicitement pas une inférence sur le fonds entier.
XLK Evidence LensLa deuxième lentille thématique — admise parce qu'elle a satisfait le standard d'admission publié, pas par popularité.
Canada Resources EvidenceVue traçable à la source de quatre lentilles de ressources canadiennes (XEG, ZEO, GDX, URNM) sur le socle documentaire 6-K/40-F. Les valeurs du niveau « éléments seulement » ne sont jamais notées.
Forward TrackingLe registre prospectif hors échantillon : une période par jour de bourse depuis le Jour 0, plus le panneau de calibration mesurant ce que chaque classification a historiquement précédé.
LedgerRacines SHA-256 quotidiennes engagées dans un dépôt git public avant la mise à jour des pages — l'ancre qui rend visible toute modification rétroactive.
MéthodologieDivulgation du rejeu en échantillon, échelle d'estimateurs, seuils score→libellé, politiques d'opérations sur titres et d'ajustement des prix, conventions de jours de bourse.
Note hebdomadaireNote du vendredi générée directement depuis le registre et le magasin d'événements ; une barrière de construction fait échouer le site si ses décomptes divergent de la chaîne.
Changements du jourCe qui a changé dans le socle d'éléments — dernier jour UTC complet plus le jour en cours.
RéplicationComment reproduire le dossier, le vocabulaire de la vérification, et le journal (honnêtement vide tant qu'il n'est pas mérité) des réplications indépendantes.

4 · Libellés de signaux et seuils publiés

YUCLAW utilise un vocabulaire figé de huit libellés (identifiants système conservés en anglais). Ce sont des classifications de recherche de type sentiment, choisies délibérément plutôt que des verbes directifs. La correspondance exacte score→libellé est publiée afin que la classification soit reproductible :

Score compositeLibelléLecture
≥ +0,55STRONG_BULLISHposture d'éléments fortement positive
≥ +0,40BULLISHposture d'éléments positive
≥ +0,20NEUTRALéléments équilibrés
≥  0,00WATCHmitigé ; sous surveillance
≥ −0,20WEAKENINGposture d'éléments en dégradation
≥ −0,40NEGATIVE_EVENTun événement matériellement négatif domine
< −0,40BEARISH_WATCHposture d'éléments fortement négative
RISK_ALERTsuperposition d'état de risque ; explicitement hors correspondance de score

Deux notes d'honnêteté accompagnent ce tableau. Premièrement, les seuils ne portent aucune promesse de résultat ; le panneau de calibration mesure les résultats — à la rédaction de ce guide, la cohérence directionnelle agrégée a un intervalle de confiance qui inclut 0,5 : la signification directionnelle n'est pas encore démontrée, et le panneau le dit. Deuxièmement, la composante d'impact des éléments (C6) porte sa propre conclusion permanente : les ventes d'initiés fonctionnent plus plausiblement comme un intrant d'état de risque que comme un signal directionnel de court terme — c'est pourquoi une valeur peut porter de lourds éléments de ventes d'initiés et un libellé de prudence sans qu'aucune affirmation directionnelle ne soit faite.

5 · Référence de la ligne de commande

CommandeFonction
yuclaw demoVisite guidée de trois minutes des idées de la plateforme.partout
yuclaw why TICKER --as-of DATEAnatomie d'un signal : composantes et événements ayant produit un score, à date.partout*
yuclaw verify TICKER --date DATEContrôle un signal contre le registre public ; affiche VERIFIED ou une explication en langage clair de ce qui n'a pas pu être contrôlé sur cette machine.partout
yuclaw replay-labRecalcule les statistiques publiées du Lab et les racines du registre depuis le paquet public. Sortie 0 = reproduction complète.partout
yuclaw events --ticker T [--since D]Liste les événements acceptés avec leurs citations de dépôts.backend
yuclaw lens NAMESynthèse d'une lentille : couverture, verdict d'admission, posture actuelle.backend
yuclaw memo --ticker TGénère un mémo d'éléments avec citations par phrase, contrôlées par machine, sous vocabulaire de conclusion restreint.backend
yuclaw export ...Exporte les données dérivées par YUCLAW (événements, signaux, statistiques). Les données brutes de marché des fournisseurs ne sont jamais redistribuées.backend

*why fonctionne partout pour les dates couvertes par les données de démonstration ; l'historique complet requiert le backend. Codes de sortie : 0 = succès · 2 = erreur d'usage (le message montre la syntaxe correcte) · 3 = environnement inadapté à la commande (explication claire, sans trace brute). Si vous voyez un jour une trace Python brute, c'est un bogue — merci de le signaler.

6 · Lire les statistiques honnêtement

Chaque statistique de YUCLAW est accompagnée d'une mécanique conçue pour empêcher la surinterprétation. Adoptez ces cinq réflexes et le site se lit correctement :

6.1 · Les badges sont la grammaire

BadgeSignification
PRELIMINARYL'intervalle pré-enregistré exclut la valeur nulle et les planchers d'échantillon sont atteints. Le libellé le plus fort que le système décerne — délibérément, rien de plus fort n'existe.
DESCRIPTIVEMesuré et publié, mais l'intervalle inclut la valeur nulle. Une description, pas une conclusion.
UNDERPOWEREDSous les planchers d'échantillon pré-enregistrés. Affiché par exhaustivité ; statistiquement non informatif.
DATA-LIMITEDL'intrant est figé, manquant ou constant ; aucune statistique n'est calculée dessus.
INCONCLUSIVEUne lecture sous barrière dont les bras n'ont pas atteint les minimums pré-engagés. Publiée, jamais enjolivée.

6.2 · Les intervalles en grappes priment sur les intervalles naïfs

Des événements partageant un émetteur ou une date ne sont pas indépendants. Partout où les deux figurent, l'intervalle tenant compte des grappes est primaire et l'intervalle naïf est étiqueté naïf. L'enveloppe conservatrice est le plus large des intervalles en grappes par émetteur et par date. Un intervalle qui exclut de justesse le zéro doit toujours se lire avec son contexte de falsification — les pages les placent côte à côte à dessein.

6.3 · Le décompte des faux positifs est imprimé à dessein

Le registre compte chaque cellule statistique secondaire jamais calculée et imprime, à côté des panneaux, le nombre attendu de découvertes dues au hasard à α=0,05. Si le site affiche des centaines de cellules exploratoires, certaines paraîtront significatives par chance — le décompte vous dit combien, avant que vous ne soyez impressionné.

6.4 · Le contexte de falsification voyage avec les résultats phares

Les résultats phares d'études d'événements sont accompagnés de tests placebo : distributions nulles par permutation des dates (le calendrier compte-t-il ?), randomisation de direction, fenêtres pré-événement. Exemple du style maison, tiré de la lentille SMH : un résultat agrégé défavorable dont le percentile de permutation des dates est banal est décrit comme un alignement directionnel générique de l'époque, pas une information datée par l'événement — le résultat tient, et son explication la plus déflationniste tient à côté.

6.5 · L'anatomie de l'échantillon prime sur sa taille

À côté de chaque panneau : émetteurs uniques, médiane d'événements par émetteur, part du premier émetteur, chevauchement des fenêtres. Cinq cents dépôts peuvent n'être que trois récits (voir §8). L'anatomie vous dit lesquels.

7 · Tout vérifier par vous-même

La revendication centrale de YUCLAW est que vous n'avez pas à lui faire confiance. Quatre parcours de vérification, par profondeur croissante :

7.1 · Reproduire le Lab (une commande)

pip install yuclaw && yuclaw replay-lab
# sortie 0 : chaque statistique et chaque racine quotidienne recalculées depuis les données publiées

7.2 · Réplication complète en environnement propre

git clone https://github.com/YuClawLab/yuclaw-brain && cd yuclaw-brain
make replicate   # récupération en environnement nettoyé → vérificateur → diff contre les sorties publiées

La page Réplication définit le vocabulaire du vérificateur — un jour exact (la racine recalculée correspond octet pour octet) et un jour à sous-ensemble ancré (artefact d'ancrage intrajournalier, divulgué, où chaque empreinte ancrée se recalcule inchangée). Les réplications indépendantes se signalent via le gabarit de ticket du dépôt ; le journal public les liste à mesure qu'elles sont méritées.

7.3 · Vérifier la chaîne du registre de protocoles

curl -sO https://raw.githubusercontent.com/YuClawLab/yuclaw-brain/main/registry/protocols.jsonl
curl -sO https://raw.githubusercontent.com/YuClawLab/yuclaw-brain/main/tools/yuclaw_protocol_registry.py
python3 -c "import yuclaw_protocol_registry as r; \
  reg=r.Registry('protocols.jsonl'); print('chaîne OK :', reg.verify_chain())"

Le registre est une chaîne d'empreintes en ajout seul : chaque ligne porte l'empreinte de la précédente. Toute modification ou suppression, où que ce soit dans l'historique, casse la chaîne pour tous les vérificateurs de la planète. Vous pouvez en outre recalculer le method_hash d'un protocole depuis le texte de spécification publié et comparer — confirmant que les spécifications n'ont pas été altérées après enregistrement.

7.4 · Suivre un élément de bout en bout

Le parcours guidé du site suit un dépôt réel depuis EDGAR jusqu'à la posture, en passant par l'extraction, le typage et la notation de l'événement — chaque étape reliée. Dix minutes, et vous saurez exactement ce qu'est un « événement accepté ».

8 · Les moteurs de recherche, en langage clair

Trois moteurs tournent en routine sur chaque lentille et chaque résultat enregistré. Leurs panneaux apparaissent sur le site sous des noms simples :

8.1 · Structure des éléments — « combien de faits indépendants, réellement ? »

Des événements partageant un émetteur et une fenêtre temporelle forment généralement un seul récit, pas plusieurs signaux. Le moteur regroupe les événements en récits selon une règle de liaison pré-engagée et calcule un décompte effectif via les effets de plan. Exemple réel de la lentille SMH : 513 dépôts → 81 événements distincts → 3 récits, un seul récit portant 95 % de la masse. Les statistiques de la page utilisent en conséquence une inférence en grappes — et vous savez désormais pourquoi.

8.2 · Robustesse contextuelle — « où cette conclusion survit-elle, et où casse-t-elle ? »

Chaque résultat primaire enregistré est ré-estimé sur une grille pré-déclarée — horizons, régimes de volatilité, régimes de tendance quand ils sont calculables, populations, époques — et résumé honnêtement : signe maintenu dans X cellules sur Y ; casse dans : [liste]. Aucun verdict réussite/échec n'existe ; les cellules incalculables le disent plutôt que d'être estimées par contournement. Une règle permanente fait de la grille une partie de la définition de « terminé » : tout nouveau résultat enregistré reçoit son profil de robustesse dans le cycle.

8.3 · Cycle de vie des éléments — « comment l'information déposée émerge, culmine et s'estompe »

Par type d'événement : la trajectoire moyenne d'ampleur après l'événement, le délai jusqu'au pic, et la demi-vie quand elle est atteinte. La lecture honnête actuelle sur les types qualifiés est aucune décroissance distinguable d'une diffusion dans la fenêtre étudiée — un résultat nul informatif, publié comme les autres.

9 · Le registre de protocoles et le pré-enregistrement

Le registre est la constitution de la plateforme. Comment le lire :

Pourquoi cela vous concerne : quand une page YUCLAW affiche un résultat, les critères de ce résultat ont été fixés avant l'arrivée des données, le nombre d'autres essais est imprimé, et le texte de la spécification peut être contrôlé par empreinte par n'importe qui. Ces trois propriétés réunies sont, en pratique, le sens de « plus difficile à falsifier ».

10 · Dossiers de preuves, exports & couche IA

10.1 · Dossiers de preuves

Chaque surface de recherche fournit un dossier téléchargeable : énoncé de couverture, synthèse d'étude d'événements, CSV des événements avec identifiants, sorties des moteurs, METADATA (date de fin des données, commit de construction, racine du registre, version de méthodologie, limites connues) et un CITATION.txt prêt à l'emploi. Les dossiers se régénèrent dans la chaîne quotidienne.

10.2 · Règles d'export — dites clairement

Les données dérivées par YUCLAW sont exportables : signaux, composantes, classifications, événements extraits de dépôts publics SEC, empreintes, statistiques, historique de suivi. Les données brutes de marché des fournisseurs (séries de prix, données d'options) ne sont jamais redistribuées — frontière de licence divulguée plutôt qu'estompée.

10.3 · Pour les agents d'IA

YUCLAW se positionne comme la couche d'éléments ouverte sous les outils de recherche pilotés par l'IA. Surfaces machine : yuclaw.ca/llms.txt (identité, vocabulaire, points d'accès, format de citation, cadre non-conseil) · evidence_index.json (carte lisible par machine de chaque page, dossier et protocole, avec URL stables et dates de fin de données) · outils de serveur MCP reflétant la CLI avec le même comportement bienveillant hors backend. Les agents consommant YUCLAW héritent de sa discipline de citation : les affirmations au niveau événement citent les identifiants d'événements des CSV.

11 · Apportez votre propre signal (service de recherche)

La mécanique de validation de YUCLAW peut s'appliquer à votre signal. Vous fournissez un CSV « à date » (date,ticker,signal_value) ; la plateforme exécute la suite diagnostique complète — coefficients d'information avec intervalles en grappes, monotonie par quantiles, rotation, décroissance par horizon, tests placebo — sous un protocole d'espace de noms client, et vous remet un mémo horodaté par empreinte plus un paquet de reproduction dont le script autonome re-dérive chaque chiffre.

Ce service fonctionne en mode accompagné pendant la phase pilote actuelle. Conditions, remise et périmètre sur demande.

12 · Limites connues

13 · État des lieux : établi et non établi

Reflet du bloc d'état partagé, rendu sur le site depuis une source unique. Les états sont mesurés, non aspirés ; les pages en direct font foi.

ÉtatÉlément
✓ Vérifiable aujourd'huiLe rejeu reproduit chaque statistique du Lab et chaque racine du registre depuis les données publiées · racines SHA-256 quotidiennes ancrées dans un git public avant mise à jour des pages · chaque événement accepté remonte à un dépôt avec numéro d'accession et extrait contrôlé · couverture affichée telle que mesurée · instantanés « à date » sans aucune modification rétroactive · les valeurs « éléments seulement » ne sont jamais notées.
✗ Non établiAlpha prospectif — aucun écart, IC ou alpha significatif à 5 % avec puissance adéquate · signification directionnelle du jeu de libellés (l'intervalle de calibration inclut 0,5) · confirmation du signe de la barrière de risque C6 (première lecture calculable programmée sous protocole verrouillé) · avance de l'étude d'événements sur les modèles de pairs.
· En accumulationLe dossier prospectif hors échantillon, quotidien · les fenêtres d'études d'événements arrivant à maturité · le bras « élevé » de C6 sous ingestion en direct · les grilles de robustesse sur les nouveaux résultats · les réplications externes, à mesure qu'elles sont signalées.

14 · Questions fréquentes

Est-ce un conseil en investissement ? Non. Recherche et éducation uniquement. Aucune sortie de YUCLAW n'est une recommandation, et la plateforme ne publie jamais de recommandation de vente ni de vente à découvert.

Pourquoi publiez-vous des résultats défavorables à votre propre hypothèse ? Parce qu'un dossier qui ne contient que des résultats favorables n'est pas un dossier. Plusieurs conclusions défavorables du site — dont des comparaisons de référence que le composite perd aux tailles d'échantillon actuelles — sont publiées sous les mêmes protocoles pré-enregistrés que tout le reste. Le produit de la plateforme est la fiabilité de son processus.

Un libellé semble erroné a posteriori — est-ce un bogue ? Non. Les libellés sont des classifications de recherche « à date » ; le panneau de calibration mesure publiquement ce que chaque libellé a historiquement précédé — y compris quand la réponse est « rien de démontrable pour l'instant ».

Pourquoi la couverture d'un fonds indiciel est-elle partielle ? Parce que YUCLAW n'analyse que les constituants relevant de son univers divulgué et de son socle documentaire, et refuse de laisser croire autre chose. Le reste non couvert est inventorié avec ses raisons sur chaque page de lentille.

Puis-je utiliser les données YUCLAW dans mes recherches ou mon produit ? Oui — les données dérivées sont sous licence Apache-2.0 et exportables, citations prêtes. Les données brutes de marché des fournisseurs ne sont pas redistribuées.

Comment signaler un bogue ou une réplication ? Via les tickets GitHub du dépôt ; les réplications disposent d'un gabarit dédié et, une fois contrôlées, entrent au journal public.

Qui est l'équipe YUCLAW ? Une opération de recherche indépendante établie à Calgary (Alberta), fonctionnant intégralement sur du matériel local souverain. La plateforme, la méthodologie et ce guide sont publiés sous le nom de l'équipe YUCLAW ; l'autorité, c'est le dossier lui-même — la chaîne, le registre quotidien, le registre de protocoles — et non un individu.

15 · Glossaire

événement acceptéÉlément typé extrait d'un dépôt, ayant passé les contrôles d'ancrage ; porte URL source, numéro d'accession et extrait contrôlé.
CARRendement anormal cumulé : rendement relatif à un modèle de référence, cumulé en jours de bourse d'événement.
IC en grappesIntervalle de confiance respectant la dépendance entre événements partageant émetteur ou date ; primaire partout où il figure.
enveloppe conservatriceLe plus large des intervalles en grappes par émetteur et par date.
estimandeQuantité estimée définie avec précision (p. ex. CAR moyen pondéré-ETF plafonné à +20 jours de bourse).
valeur « éléments seulement »Valeur ingérée et analysée mais jamais notée ; exclue de l'univers noté de 79 valeurs par barrière imposée par machine.
IC (coefficient)Coefficient d'information : corrélation de rangs transversale entre un score et les rendements à venir.
N_eff / effet de planNombre effectif d'observations indépendantes après prise en compte des grappes ; N_eff = N / DEFF.
« à date » (point-in-time)Consigné avec l'information disponible à cet instant, et jamais modifié ensuite.
protocole / exécution / supersessionVoir §9 — les trois types d'enregistrements du registre.
récit (story)Grappe d'événements liés par émetteur et par temps selon une règle pré-engagée ; l'unité d'élément indépendant.

16 · Citer YUCLAW

YUCLAW <nom de la page>, données jusqu'au <date>, build <commit>,
https://github.com/YuClawLab/yuclaw-brain
# ou utilisez le CITATION.txt prêt à l'emploi de tout dossier de preuves ;
# les affirmations au niveau événement citent les identifiants des CSV du dossier.

Liens : yuclaw.ca · GitHub github.com/YuClawLab/yuclaw-brain · PyPI pypi.org/project/yuclaw · surface machine yuclaw.ca/llms.txt

Avertissement final. Illustration de recherche hypothétique. Ni conseil en investissement, ni publicité de performance, ni offre de produit. Les classifications de recherche ne sont pas des recommandations. Les résultats passés — en échantillon comme en suivi prospectif — ne préjugent pas des performances futures. En cas de divergence, l'édition anglaise et les pages en direct font foi. © 2026 L'équipe YUCLAW · Licence Apache-2.0 · recherche et éducation uniquement.