@ogygie/cli 0.17.0 → 0.18.0

package/dist/cli.js

@@ -15952,6 +15952,18 @@ var governedChecksumsByVersion = {
     "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.17.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.17.0",
+    "@ogygie/core": "0.18.0",
     "@types/node": "^24.0.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.20.0",

package/templates/project/AGENTS.md

@@ -311,14 +311,21 @@ Tailwind du produit déclare le paquet comme source
 
 ### 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
@@ -367,9 +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.
-- Les états d'un écran — accès refusé, erreur, chargement, vide — passent par
-  `ScreenState`, jamais par une cascade de `if` propre à l'écran : le corps ne reçoit
-  que des données servies.
+- 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/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.",
       });
     }
   }