@sylad/cadence 0.10.0 → 0.10.1

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
     {
       "name": "cadence",
       "description": "Session start and close rituals driven by a versioned plan (raf), and deliveries proven by their effect. Needs the cadence CLI (npm i -g @sylad/cadence).",
-      "version": "0.10.0",
+      "version": "0.10.1",
       "source": "./",
       "author": { "name": "Sylvain Ladoire" }
     }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cadence",
   "description": "A repo-native working method: session start and close rituals driven by a versioned plan (raf), deliveries proven by their effect, and three reviewer agents (UX, code, QA).",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "author": { "name": "Sylvain Ladoire" },
   "homepage": "https://github.com/Sylad/cadence",
   "repository": "https://github.com/Sylad/cadence",

package/README.md

@@ -36,7 +36,8 @@ reports a page left empty or in error.
   touches is a plan file**: the plan itself, its Gantt page (only at its default place, `gantt.html` next to the plan — written elsewhere with `raf gantt -o`, declare it under `plan.files`), the `plan:` key of the config file in use (`cadence.yaml`, or
   the `--config` file; a change to `deliver:`/`session:` is work), or a file the
   project lists under `plan.files` in `cadence.yaml` (a page it generates from
-  the plan, a journal). Such a commit is never a "commit without a lot", and it
+  the plan, a journal), or the QA expectations file (`docs/qa/expectations.md`,
+  or the file named by `qa.expectations`; the lead commits the `qa-reviewer`'s draft of it). Such a commit is never a "commit without a lot", and it
   does not count as work on the lots it cites: it is absent from `raf commits`,
   does not start a `todo` lot, does not make a code review stale, and
   `cadence deliver` does not announce the lots it cites as delivered. The files
@@ -274,8 +275,8 @@ The counterpart of the UX review, off by default. With the rule on, `raf done`
 refuses a lot that has at least one commit citing it and no recorded verdict
 (`--force` to override), and `raf check` reports such lots finished after the
 `reviewSince` day. A lot with no commit has nothing to review; neither does a
-lot whose only commits touch plan files alone (the plan, or a file listed under
-`plan.files`), predate the plan's `since` or match an `ignore:` pattern — `raf commits <id>` prints exactly the counted set.
+lot whose only commits touch plan files alone (the plan, a file listed under
+`plan.files`, or the QA expectations file), predate the plan's `since` or match an `ignore:` pattern — `raf commits <id>` prints exactly the counted set.
 
 The verdict is tied to what was reviewed: `raf review` stores it on the lot with
 the sha of the lot's latest counted commit (`review: { date, verdict, commit }`,
@@ -346,7 +347,7 @@ qa:
   expectations: docs/quality/pages.md
 ```
 
-Only the agent reads that key; the CLI does not use it. Without an expectations file the agent walks
+The agent reads that key, and so does `raf check`: a commit touching only that file is plan upkeep (no lot to cite, see above). Without an expectations file the agent walks
 the routes it discovers and still runs its universal checks: an error shown, a failed API call
 whose content is missing on screen, a broken or missing content image are defects with or without a
 file; an empty 2xx body, like whatever else would need an expectation to judge, is suspect at most
@@ -725,7 +726,7 @@ orchestrate:
 
 Without `start`, a read-only plan's `todo` lot is refused (start it with the project's tool); without
 `verdict`, the review verdict stays in the wave's state and you report it. Only the plan's files
-(`plan.path`, `plan.files`) are committed from those commands; anything else dirty stops the lot.
+(`plan.path`, `plan.files`, the QA expectations file) are committed from those commands; anything else dirty stops the lot.
 
 ## Claude Code skills
 

package/dist/audit.js

@@ -12,7 +12,7 @@ function configRel(plan, root) {
 }
 /** Le plan, sa page Gantt, la configuration lue (cadence.yaml) et les fichiers tenus avec lui (plan.files). */
 function ownFiles(plan, root) {
-    return new Set([relative(root, plan.path), relative(root, join(dirname(plan.path), 'gantt.html')), configRel(plan, root), ...plan.files]);
+    return new Set([relative(root, plan.path), relative(root, join(dirname(plan.path), 'gantt.html')), configRel(plan, root), ...plan.maintained]);
 }
 function withoutPlanKey(text) {
     if (text === null)
@@ -39,7 +39,7 @@ export function planCommits(plan, root, opts = {}) {
 }
 /**
  * Commit d'entretien du plan : TOUS ses fichiers sont des fichiers du plan (le plan, sa page Gantt,
- * plan.files — son plan publié par exemple — et la configuration lue, mais celle-ci seulement quand la
+ * plan.files — son plan publié par exemple —, les attendus QA et la configuration lue, mais celle-ci seulement quand la
  * clé `plan:` est la seule à changer : deliver/session/… sont du travail). Les fichiers décident,
  * jamais le sujet : « chore(plan): … » qui touche un fichier source est un commit comme un autre.
  */

package/dist/cli.js

@@ -47,7 +47,7 @@ Quand la portée du sujet cite des lots — « feat(L3): … », « chore(L31,L3
 mention en passage (« page équipe (L27) »), une plage (« L28–L31 », « L45 à L48 ») ou le corps n'y comptent pas.
 Sans portée citant un lot, tout le message est lu : « fix: L3 corrigé », « L3/t1 ».
 Un commit qui ne touche que le plan, la clé plan: de cadence.yaml (deliver/session sont du travail) (et les fichiers déclarés sous plan.files, un plan
-publié par exemple) n'a pas à en citer, et ne compte pas pour les lots qu'il cite ; le sujet n'y change rien.
+publié par exemple, ainsi que le fichier d'attendus QA : docs/qa/expectations.md ou qa.expectations) n'a pas à en citer, et ne compte pas pour les lots qu'il cite ; le sujet n'y change rien.
 Un lot --visible attend une entrée Nouveautés (docs/nouveautes/, --dir) avec capture ; raf check le vérifie.
 Un texte qui commence par « - » se passe après « -- » : raf note L1 -- "-5 %".
 Le plan est docs/plan/raf.yaml, ou celui que nomme « plan: » dans cadence.yaml ; un plan tenu par un

package/dist/config.js

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, posix, relative } from 'node:path';
 import { parse } from 'yaml';
 import { isDay } from './dates.js';
 import { FIELDS, RafError, STATUSES } from './plan.js';
@@ -6,6 +7,29 @@ const KEYS = ['path', 'project', 'since', 'ignore', 'files', 'lots', 'fields', '
 const FORMAT_KEYS = ['lots', 'fields', 'statuses', 'estimates'];
 const isObject = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
 const list = (v) => (v == null ? [] : Array.isArray(v) ? v.map(String) : [String(v)]);
+/**
+ * Clé `qa:` : le fichier d'attendus QA, ramené à la forme que git rapporte (relatif à la racine du dépôt,
+ * séparateurs posix, sans `./`). Une valeur vide vaut absente ; un type faux ou un chemin hors du dépôt est refusé.
+ */
+function readQa(qa, file) {
+    if (qa == null)
+        return undefined;
+    if (!isObject(qa))
+        throw new RafError(`${file} : qa doit être un objet`);
+    const v = qa.expectations;
+    if (v == null)
+        return undefined;
+    if (typeof v !== 'string')
+        throw new RafError(`${file} : qa.expectations doit être un chemin`);
+    const raw = v.trim().replace(/\\/g, '/');
+    if (raw === '')
+        return undefined;
+    const root = dirname(file);
+    const rel = posix.normalize(isAbsolute(raw) ? relative(root, raw).replace(/\\/g, '/') : raw);
+    if (rel === '.' || rel === '..' || rel.startsWith('../') || isAbsolute(rel))
+        throw new RafError(`${file} : qa.expectations « ${v.trim()} » est hors du dépôt`);
+    return rel;
+}
 /**
  * Clé `plan:` de cadence.yaml : où est le plan et, s'il est tenu par un autre outil, comment le lire.
  * Null quand le fichier ou la clé manque — le plan est alors docs/plan/raf.yaml au format de raf.
@@ -20,18 +44,22 @@ export function readPlanConfig(file) {
     catch (e) {
         throw new RafError(`${file} illisible : ${e.message.split('\n')[0]}`);
     }
-    const p = raw?.plan;
+    const doc = raw;
+    const qa = readQa(doc?.qa, file);
+    const p = doc?.plan;
     if (p == null)
-        return null;
+        return qa ? { settings: { qaExpectations: qa } } : null;
     const bad = (what) => new RafError(`${file} : plan.${what}`);
     if (typeof p === 'string' && p.trim() !== '')
-        return { path: p, settings: {} };
+        return { path: p, settings: { ...(qa ? { qaExpectations: qa } : {}) } };
     if (!isObject(p))
         throw new RafError(`${file} : plan doit être un chemin ou un objet`);
     for (const k of Object.keys(p))
         if (!KEYS.includes(k))
             throw bad(`${k} inconnu (attendu : ${KEYS.join(', ')})`);
     const settings = {};
+    if (qa)
+        settings.qaExpectations = qa;
     if (p.project != null)
         settings.project = String(p.project);
     if (p.since != null) {

package/dist/orchestrate/cycle.js

@@ -72,7 +72,7 @@ function trackedPaths(s) {
 async function commitPlan(c, message) {
     const repo = c.lot.repo;
     const plan = c.loadPlan();
-    const own = new Set([relative(repo, plan.path), ...plan.files]);
+    const own = new Set([relative(repo, plan.path), ...plan.maintained]);
     const dirty = trackedPaths(await snapshot(repo, { remote: false }));
     if (dirty.length === 0)
         return null;

package/dist/plan.js

@@ -130,6 +130,14 @@ export class Plan {
     get files() {
         return this.settings.files ?? [];
     }
+    /** Fichier d'attendus QA du `qa-reviewer`, relatif à la racine du dépôt. */
+    get qaExpectations() {
+        return this.settings.qaExpectations ?? 'docs/qa/expectations.md';
+    }
+    /** Tout ce qui est tenu avec le plan sans être du travail : plan.files et le fichier d'attendus QA. Source unique de l'audit et de l'orchestrateur. */
+    get maintained() {
+        return [...this.files, this.qaExpectations];
+    }
     /**
      * Références citées par un texte. Format de raf : préfixe et numéro (`L3`, `L3/t1`). Autre format :
      * les identifiants du plan eux-mêmes, quelle que soit leur forme (`E-A2`, `NC2.4`, `B33/t1-fusion`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sylad/cadence",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "A small, repo-native working method: a versioned plan linked to your commits, a changelog with screenshots, session rituals and deliveries proven by their effect.",
   "license": "MIT",
   "author": "Sylvain Ladoire",