@ogygie/cli 0.16.0 → 0.18.0

package/dist/cli.js

@@ -15940,6 +15940,30 @@ var governedChecksumsByVersion = {
     "scripts/verify-specs.ts": "03d58baa11822ad7ae67080f990f7a82f4f94d223b12777728b8b9ddd7ebd843",
     "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
   },
+  "0.17.0": {
+    ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
+    "AGENTS.md": "e058a54ff4750abf19f7c4b026e8be661d8ce25419596d22c20de2c387469370",
+    "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
+    "scripts/lint-interdits.ts": "4644e1aaabc1d19ed42a0bdf8e2e55b9451f789d87d59754bce3432de7c357e7",
+    "scripts/ogygie-design-brief.ts": "aba1585717b30808dd0bc8930a37a1ad2d83ee6869f969dbd06ca595e37a4a89",
+    "scripts/ogygie-impact.ts": "f06cc8b4a46ddfbcfb32ba747c2454548ca49918123d04ab13d210b4a89c1fb9",
+    "scripts/verify-contracts.ts": "9cd64c88dcc3b54b65bf1e1b7a68eb00353ee16f2a9ce8bca3c49ba063c2a08b",
+    "scripts/verify-manifest.ts": "6c448fa3a19b87666f686ca57c6ca834d9e169b1380e4fe6e4c19b995bf94f3c",
+    "scripts/verify-specs.ts": "03d58baa11822ad7ae67080f990f7a82f4f94d223b12777728b8b9ddd7ebd843",
+    "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
+  },
+  "0.18.0": {
+    ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
+    "AGENTS.md": "8356696ef27c53cad164ab0086163454348b18852b121eca9fb050fb73e625f0",
+    "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
+    "scripts/lint-interdits.ts": "4644e1aaabc1d19ed42a0bdf8e2e55b9451f789d87d59754bce3432de7c357e7",
+    "scripts/ogygie-design-brief.ts": "aba1585717b30808dd0bc8930a37a1ad2d83ee6869f969dbd06ca595e37a4a89",
+    "scripts/ogygie-impact.ts": "f06cc8b4a46ddfbcfb32ba747c2454548ca49918123d04ab13d210b4a89c1fb9",
+    "scripts/verify-contracts.ts": "9cd64c88dcc3b54b65bf1e1b7a68eb00353ee16f2a9ce8bca3c49ba063c2a08b",
+    "scripts/verify-manifest.ts": "6c448fa3a19b87666f686ca57c6ca834d9e169b1380e4fe6e4c19b995bf94f3c",
+    "scripts/verify-specs.ts": "92d54aa5111fe0753aa9d6eb3b4ac89a7f24fa06578ea3369ccb0dc9d4c3dd88",
+    "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
+  },
   "0.2.0": {
     ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
     "AGENTS.md": "ca73ab619d8c55fac11858d815bf5fbab6537ecebe7ae4123cbdeb3e3e36bf1a",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygie/cli",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Ogygie framework CLI: deterministic scaffolding (init), governed-file upgrades (upgrade) and lockstep verification (check) for Ogygie products.",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@ogygie/core": "0.16.0",
+    "@ogygie/core": "0.18.0",
     "@types/node": "^24.0.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.20.0",

package/templates/project/AGENTS.md

@@ -295,23 +295,37 @@ dérogation qui s'oublie. Elle ne couvre JAMAIS le code du produit lui-même.
 ### Stack imposée (toute autre lib = amendement DECISIONS.md d'abord)
 Vite + React 19 + TanStack Router (routing EN CODE) + TanStack Query (état serveur) ;
 PAS de lib d'état client (useState suffit) ; Tailwind v4 thémé depuis `design/tokens.json`
-(valeurs arbitraires `p-[13px]` interdites par lint) ; primitives UI copiées dans
-`apps/web/src/patterns/` (jamais consommées directement depuis node_modules par une
-feature) ; react-hook-form UNIQUEMENT via le pattern `ContractForm` ; TanStack
-Table UNIQUEMENT via `DataTable` ; Recharts UNIQUEMENT via `VarianceChart` ;
+(valeurs arbitraires `p-[13px]` interdites par lint) ; le socle de patterns vient du
+paquet `@ogygie/ui` — `ScreenState`, `EmptyState`, `ErrorBanner`, `EditableText`,
+`fetchContract`, et derrière leur propre point d'entrée `DataTable`
+(`@ogygie/ui/data-table`), `ContractForm` (`@ogygie/ui/contract-form`),
+`VarianceChart` (`@ogygie/ui/variance-chart`) — IMPORTÉ, jamais recopié ; les
+patterns PRODUIT vivent dans `apps/web/src/patterns/` (jamais consommés directement
+depuis node_modules par une feature) ; react-hook-form UNIQUEMENT via `ContractForm` ;
+TanStack Table UNIQUEMENT via `DataTable` ; Recharts UNIQUEMENT via `VarianceChart` ;
 date-fns via les helpers `@ogygie/core` (jamais de `new Date()` nu) ; i18n Lingui
-(ICU, extraction vérifiée en CI). Noms de patterns en anglais.
+(ICU, extraction vérifiée en CI) — `@ogygie/ui` ne porte AUCUNE chaîne : tout texte
+lui arrive en prop, traduit par la feature. Noms de patterns en anglais. La feuille
+Tailwind du produit déclare le paquet comme source
+(`@source "../node_modules/@ogygie/ui/src";`), sinon ses classes ne sont pas générées.
 
 ### Structure d'une feature front (miroir de l'API)
 ```
-apps/web/features/orders/
-├── index.ts            # seul export public
-├── routes.tsx          # définition TanStack Router de la feature
-├── queries.ts          # hooks TanStack Query (fetch + invalidations)
-├── OrdersList.tsx      # écrans = composition de patterns, rien d'autre
-├── OrderForm.tsx
-└── OrdersList.test.tsx # un test par état UI de la spec
+apps/web/src/features/orders/
+├── index.ts                     # seul export public
+├── routes.tsx                   # fabrique createRoute de la feature, que le routeur de l'app ajoute à ses enfants
+├── queries.ts                   # hooks TanStack Query de LECTURE (clés de cache dérivées du manifeste)
+├── writes.ts                    # hooks de MUTATION (invalidations dérivées du manifeste)
+├── OrdersScreen.container.tsx   # le CONTENEUR : lit les hooks, déroule les états par ScreenState, passe au corps des données servies
+├── OrdersScreen.tsx             # le CORPS : reçoit data, QueryLike et MutationLike — jamais un hook ; compose les vues
+├── views/OrdersList.tsx         # une vue = un pattern (DataTable, ContractForm, VarianceChart…) sur UNE opération
+├── views/OrderForm.tsx
+└── OrdersScreen.test.tsx        # un test par état UI de la spec : le conteneur sous un fetch simulé, ou le corps sur des QueryLike
 ```
+Une feature générée porte les mêmes fichiers à l'infixe `.gen` près
+(`queries.gen.ts`, `writes.gen.ts`, `OrdersScreen.container.gen.tsx`,
+`views/OrdersList.gen.tsx`, `routes.gen.tsx`) ; son corps `OrdersScreen.tsx`
+et ses vues `custom` restent écrits.
 
 ### Template canonique — hook de requête
 ```ts
@@ -319,7 +333,7 @@ apps/web/features/orders/
 /** @intent Data access of the orders feature. Re-validates contracts in dev. */
 import { useQuery } from "@tanstack/react-query";
 import { ListOrdersOutputSchema } from "@product/api/features/orders/schemas";
-import { fetchContract } from "../../lib/fetchContract"; // Zod parse in dev, OgygieError on broken contract
+import { fetchContract } from "@ogygie/ui"; // Zod parse of the answer; an OgygieFailure on a refused call or a broken contract
 
 export function useOrders() {
   return useQuery({
@@ -334,18 +348,25 @@ export function useOrders() {
 // apps/web/features/orders/OrdersList.tsx
 /** @intent Orders list screen: composition of patterns, zero business logic. */
 import { Trans } from "@lingui/react/macro";
-import { DataTable } from "../../patterns/DataTable";
-import { EmptyState } from "../../patterns/EmptyState";
-import { ErrorBanner } from "../../patterns/ErrorBanner";
+import { ScreenState } from "@ogygie/ui";
+import { DataTable } from "@ogygie/ui/data-table";
 import { useOrders } from "./queries";
 
 export function OrdersList() {
-  const { data, isPending, error } = useOrders();
-  if (error) return <ErrorBanner error={error} />;
-  if (isPending) return <DataTable.Skeleton />;
-  if (data.orders.length === 0)
-    return <EmptyState title={<Trans>Ajoutez votre première commande</Trans>} />;
-  return <DataTable rows={data.orders} columns={orderColumns} />;
+  return (
+    <ScreenState
+      query={useOrders()}
+      errorTitle={<Trans>Cette vue n'a pas pu être chargée</Trans>}
+      loading={<DataTable.Skeleton />}
+      isEmpty={(data) => data.orders.length === 0}
+      emptyState={{
+        title: <Trans>Ajoutez votre première commande</Trans>,
+        explanation: <Trans>Les commandes enregistrées apparaissent ici.</Trans>,
+      }}
+    >
+      {(data) => <DataTable rows={data.orders} columns={orderColumns} rowKey={(order) => order.id} />}
+    </ScreenState>
+  );
 }
 ```
 
@@ -353,6 +374,11 @@ export function OrdersList() {
 - Un écran est une COMPOSITION de patterns : jamais de `<table>`, `<form>` ou fetch nus
   dans une feature. Si un pattern manque, on le crée dans `patterns/` (et on met à jour
   `design/patterns.md`), on ne bricole pas dans la feature.
+- Un écran est un CONTENEUR et un CORPS. Le conteneur lit les hooks (route, lectures,
+  écritures) et déroule les états — accès refusé, erreur, chargement — par
+  `ScreenState`, jamais par une cascade de `if` ; le corps reçoit la lecture
+  principale SERVIE, les autres lectures en `QueryLike` et les écritures en
+  `MutationLike`, jamais un hook : il se teste sans client de requêtes ni réseau.
 - Chaque état UI listé dans la spec (vide/chargement/nominal/erreur) a son test.
 - Toute chaîne visible passe par Lingui (`<Trans>`/`t`) — la CI casse sinon.
 - Chiffres financiers : `tabular-nums`, alignés à droite, unité explicite.

package/templates/project/design/patterns.md

@@ -2,27 +2,35 @@
 
 > Les patterns sont les SEULES briques d'écran autorisées (AGENTS.md §Front) :
 > un écran est une COMPOSITION de patterns, jamais de `<table>`, `<form>` ni
-> fetch nus. Le starter n'a pas encore d'app front produit : à l'ouverture du
-> premier front, chaque pattern retenu est COPIÉ dans `apps/web/src/patterns/`
-> et sa fiche ci-dessous devient son contrat. Un pattern manquant se crée ICI
-> d'abord (fiche + décision), jamais en one-off dans un écran.
+> fetch nus. Les patterns GÉNÉRIQUES ci-dessous sont LIVRÉS par le paquet
+> `@ogygie/ui` : un produit les importe, il ne les recopie pas, et leur fiche
+> ci-dessous est leur contrat. Un pattern PRODUIT — propre au domaine — naît
+> dans `apps/web/src/patterns/` avec sa fiche ICI d'abord, jamais en one-off
+> dans un écran. Tout texte lu par un humain arrive à un pattern générique en
+> prop, traduit par la feature (Lingui) : le paquet ne porte aucune chaîne.
 >
 > Ce catalogue est une source de vérité du brief de design
 > (`pnpm ogygie:design-brief <feature>`) : chaque fiche `## <Name>` devient
 > une entrée du vocabulaire de composition. Noms en anglais (machine-lisible),
 > fiches en français (document humain).
 
+## ScreenState
+Le composant d'état UNIQUE d'un écran (`@ogygie/ui`). Reçoit la lecture (`QueryLike`, sous-ensemble d'un résultat TanStack Query) et le corps en fonction de rendu, et décide dans cet ordre : accès refusé (`denied` de l'appelant, ou une réponse 401/403 quand une copie `accessDenied` est donnée), erreur (`ErrorBanner`, titré par `errorTitle`), chargement (`loading`, à défaut `Skeleton`), vide (`isEmpty` + `emptyState`, un `EmptyState` avec son action), puis le corps avec des données servies. Un corps ne branche jamais sur `undefined`.
+
 ## DataTable
-Tableau de données (TanStack Table, seul usage autorisé). États : squelette de chargement (`DataTable.Skeleton`), vide (déléguer à EmptyState), nominal trié/paginé, erreur (déléguer à ErrorBanner). Chiffres en `tabular-nums` alignés à droite, unité explicite.
+Tableau de données (`@ogygie/ui/data-table`, TanStack Table — seul usage autorisé). Colonnes typées `{ id, header, cell, sortValue?, align? }` ; tri par clic d'en-tête (`aria-sort`), chiffres `align: "end"` en `tabular-nums` alignés à droite, unité explicite dans la cellule. États : squelette de chargement (`DataTable.Skeleton`), vide DÉLÉGUÉ (`emptyState` : un `EmptyState` qui dit pourquoi), nominal trié ; l'erreur appartient à `ScreenState`. La liste de colonnes reste stable (module ou `useMemo`).
 
 ## EmptyState
-État vide intentionnel : un titre, une explication courte, UNE action de création. Jamais de tableau ou de liste vides nus — l'écran vide est le premier écran que voit chaque nouvel utilisateur.
+État vide intentionnel (`@ogygie/ui`) : un titre qui nomme la CAUSE, une explication qui dit ce qui le remplirait, UNE action de création au plus. Jamais de tableau ou de liste vides nus — l'écran vide est le premier écran que voit chaque nouvel utilisateur. Deux causes, deux formulations : rien d'enregistré, ou un filtre qui ne trouve rien.
 
 ## ErrorBanner
-Bandeau d'erreur qui affiche une OgygieError : message traduit via `userMessageKey` (clé ICU), code stable et `suggestedFix` repliables. Tout état d'erreur d'écran passe par lui — jamais de message d'erreur improvisé.
+Bandeau d'erreur (`@ogygie/ui`) : affiche une `OgygieFailure` en entier — le titre du produit, le message, le code stable avec le statut et la cause, la correction suggérée — et dégrade toute autre erreur à son message. `kind: "save"` marque une écriture refusée (le produit titre autrement) ; `retry` ajoute le bouton que le produit libelle. Tout état d'erreur d'écran passe par lui — jamais de message improvisé.
 
 ## ContractForm
-Formulaire DÉRIVÉ d'un contrat Zod (react-hook-form, seul usage autorisé) : les contraintes du schéma (min/max/regex, obligatoire) sont les validations des champs — rien n'est redéclaré à la main. États : saisie, soumission en cours (bouton désactivé), erreurs de champ, erreur serveur (ErrorBanner).
+Formulaire DÉRIVÉ d'un contrat Zod (`@ogygie/ui/contract-form`, react-hook-form — seul usage autorisé) : les champs viennent de la forme du schéma, leurs contrôles de leur genre (texte, nombre, date, sélection d'enum, case à cocher), leurs contraintes des bornes du schéma — rien n'est redéclaré à la main — et le schéma valide chaque soumission (`safeParse`). Libellés, aides, libellés d'options, `submitLabel` et `cancel` sont des props traduites ; `renderIssue` traduit la phrase d'un refus. États : saisie, soumission en cours (bouton inactif, `pending`), erreur de champ (une phrase sous le champ), erreur de formulaire (un `refine`), erreur serveur (`error` : un `ErrorBanner` save au-dessus des actions). `onSubmit` reçoit la SORTIE parsée du contrat.
 
 ## VarianceChart
-Graphique d'écart (Recharts, seul usage autorisé) : compare une valeur constatée à une référence. États : chargement, vide, nominal, erreur. Montants en `tabular-nums`, axe et unité toujours étiquetés.
+Graphique d'écart (`@ogygie/ui/variance-chart`, Recharts — seul usage autorisé) : une valeur constatée (`measured`) contre une référence (`reference`), par libellé, en deux barres groupées ; l'écart signé se lit dans l'infobulle ; une ligne zéro quand les valeurs la traversent. Couleurs tirées des tokens du produit par variables CSS, noms de séries et unité en props traduites. États : vide DÉLÉGUÉ (`emptyState`), squelette (`VarianceChart.Skeleton`) ; chargement et erreur appartiennent à `ScreenState`. Montants en `tabular-nums`, axe et unité toujours étiquetés.
+
+## EditableText
+Texte qui s'écrit là où il se lit (`@ogygie/ui`) : un clic le transforme en champ, quitter le champ ou Entrée enregistre, Échap abandonne. Un lecteur sans droit voit le texte nu, jamais un contrôle inactif. Un brouillon blanc est refusé sans écriture (sauf `allowEmpty`) ; une borne (`maxLength`) arrête le champ et affiche le compteur ; `pending` rend le contrôle inactif le temps d'une écriture. `placeholder` et `ariaLabel` sont traduits par la feature.

package/templates/project/scripts/verify-specs.ts

@@ -131,8 +131,8 @@ for (const fileName of specFiles) {
 
   if (frontmatter.status === "draft") {
     // What counts as an implementation is the core's rule, not this script's:
-    // a package's folder is REQUIRED by the manifest gate, so its existence
-    // proves nothing (see hasImplementation).
+    // the STATUS the map declares, never a folder (see hasImplementation) — a
+    // generated folder waits on its branch while the spec awaits its signature.
     const implemented =
       owner !== undefined && hasImplementation(owner, ownerDir !== null && existsSync(ownerDir));
     if (implemented) {
@@ -140,9 +140,9 @@ for (const fileName of specFiles) {
         code: "SPEC_DRAFT_ALREADY_IMPLEMENTED",
         message: `Spec ${fileName} is draft but an implementation exists.`,
         file: specPath,
-        cause: "status=draft with code or a non-skeleton manifest entry",
+        cause: "status=draft while the manifest entry is in-progress or delivered",
         suggestedFix:
-          "Move the spec to validated/implemented, or remove the premature implementation.",
+          "Move the spec to validated/implemented, or declare the entry skeleton while the spec awaits its validation — a folder on a branch is a proposal, not a delivery.",
       });
     }
   }