devmethod-ai 0.1.0 → 0.3.0

package/examples/clair-from-zero/app/styles.css

@@ -0,0 +1,128 @@
+:root{--paper:#f7f3eb;--ink:#292923;--muted:#726e63;--rust:#97472f;--line:#d9d3c7;--panel:#eee9df;--serif:Georgia,'Times New Roman',serif;--sans:Arial,Helvetica,sans-serif}
+*{box-sizing:border-box}
+body{margin:0;background:var(--paper);color:var(--ink);font-family:var(--sans);font-size:14px}
+button,input,textarea{font:inherit}
+button,a,input,textarea{-webkit-tap-highlight-color:transparent}
+button{cursor:pointer}
+button{color:inherit}
+button:focus-visible,a:focus-visible,input:focus-visible,textarea:focus-visible,[tabindex]:focus-visible{outline:3px solid var(--rust);outline-offset:5px}
+button:hover{filter:brightness(.86)}
+[hidden]{display:none!important}
+.page{max-width:1480px;padding:0 64px;margin:auto}
+.masthead{height:100px;display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid var(--line);gap:24px}
+.brand{font-family:var(--serif);font-size:44px;letter-spacing:-3px;color:var(--ink);text-decoration:none}
+.brand-dot{color:var(--rust);font-size:28px;display:inline-block;vertical-align:top;margin:5px 0 0 7px}
+.masthead-note,.edition,.eyebrow,.hero-aside>span,.footer-note{font-size:10px;letter-spacing:1.8px;font-weight:600}
+.edition{color:var(--muted)}
+.hero{display:flex;align-items:center;justify-content:space-between;padding:57px 0 50px}
+.eyebrow{color:var(--rust);margin:0 0 23px}
+.hero h1{font:normal clamp(58px,5.7vw,82px)/1.04 var(--serif);letter-spacing:-3.3px;margin:0}
+.hero h1 em{font-weight:normal;color:var(--rust)}
+.intro{font-size:15px;line-height:1.7;color:var(--muted);margin:23px 0 0}
+.hero-aside{width:28%;text-align:center;padding-top:8px}
+.hero-aside p{font:italic 24px/1.4 var(--serif);margin:18px 0;color:var(--muted)}
+.hero-aside>span{font-size:9px;color:var(--muted)}
+.sun{position:relative;width:90px;height:90px;margin:0 auto}
+.sun i{position:absolute;top:44px;left:0;width:90px;height:1px;background:var(--rust)}
+.sun i:nth-child(2){transform:rotate(45deg)}
+.sun i:nth-child(3){transform:rotate(90deg)}
+.sun i:nth-child(4){transform:rotate(135deg)}
+.sun:after{content:'';position:absolute;inset:30px;border:1px solid var(--rust);border-radius:50%;background:var(--paper)}
+.workspace{display:grid;grid-template-columns:minmax(0,1.8fr) minmax(290px,1fr);gap:48px;border-top:1px solid var(--ink);padding-top:32px;padding-bottom:55px}
+.section-heading{display:flex;justify-content:space-between;align-items:center;margin-bottom:25px}
+.section-heading h2{font:normal 30px var(--serif);letter-spacing:-.6px;margin:0}
+.count{font:normal 27px var(--serif);color:var(--muted)}
+.list-toolbar{display:flex;justify-content:space-between;align-items:center;gap:16px}
+.filters{display:flex;gap:19px}
+.filters button{font-size:12px;border:0;background:transparent;padding:9px 0;color:var(--muted);border-bottom:2px solid transparent;white-space:nowrap}
+.filters button[aria-pressed=true]{color:var(--rust);border-bottom-color:var(--rust);font-weight:bold}
+.filters span{font-size:10px;margin-left:3px}
+.progress-label{font-size:10px;color:var(--muted);white-space:nowrap}
+.progress-track{height:2px;background:var(--line);margin:10px 0 0}
+.progress-track div{height:100%;background:var(--rust);transition:width .2s ease}
+.empty-state{min-height:285px;display:flex;align-items:center;justify-content:center;flex-direction:column;text-align:center;padding:32px 10px}
+.empty-mark{font-size:43px;color:var(--rust);margin:0 0 15px}
+.empty-state h3{font:normal 25px var(--serif);margin:0 0 12px;letter-spacing:-.3px}
+.empty-state p{line-height:1.7;color:var(--muted);font-size:13px;margin:0}
+.text-button{border:0;background:none;color:var(--rust);font-size:12px;border-bottom:1px solid var(--rust);padding:0 0 5px;margin-top:22px}
+.text-button span{margin-left:14px}
+.list-foot{display:flex;justify-content:space-between;gap:15px;border-top:1px solid var(--line);padding-top:19px;font-size:10px;color:var(--muted)}
+.list-foot button{border:0;padding:0 0 2px;background:transparent;color:var(--rust);font-size:10px;border-bottom:1px solid var(--rust)}
+.composer{background:var(--panel);padding:29px 29px 23px;align-self:start}
+.composer .eyebrow{font-size:9px;margin-bottom:16px}
+.composer h2{font:normal 29px/1.15 var(--serif);letter-spacing:-.7px;margin:0 0 27px}
+.composer h2 em{color:var(--rust)}
+label{display:block;font-size:11px;font-weight:bold;margin:0 0 10px}
+label>span:not(.optional){color:var(--rust)}
+.optional{font-weight:normal;color:var(--muted)}
+input,textarea{width:100%;border:1px solid #c9c1b2;border-radius:0;color:var(--ink);background:#faf7f1;padding:13px 12px;font-size:12px;line-height:1.5}
+input{margin-bottom:20px}
+textarea{resize:vertical;min-height:91px}
+input::placeholder,textarea::placeholder{color:#817b6f}
+input[aria-invalid=true]{border-color:var(--rust)}
+.add-button{margin-top:17px;display:flex;align-items:center;justify-content:space-between;background:var(--rust);color:white;border:0;padding:14px 17px;width:100%;font-size:12px}
+.add-button span{font-size:21px;line-height:1}
+.form-tip{font-size:11px;line-height:1.6;color:var(--muted);margin:20px 0 0}
+.form-error{color:#8a2c20;font-size:12px;line-height:1.5;margin:12px 0 0}
+#task-list{list-style:none;padding:0;margin:0}
+.task{display:grid;grid-template-columns:24px minmax(0,1fr) 30px;align-items:start;gap:14px;border-bottom:1px solid var(--line);padding:23px 0}
+.task:last-child{border-bottom:0}
+.task-check{width:22px;height:22px;padding:0;border:1px solid #9c9586;background:transparent;margin-top:2px;display:grid;place-items:center}
+.task.done .task-check{background:var(--rust);border-color:var(--rust);color:white}
+.task h3{font:normal 21px/1.3 var(--serif);margin:0;overflow-wrap:anywhere}
+.task p{margin:8px 0 0;color:var(--muted);font-size:12px;line-height:1.6;white-space:pre-wrap;overflow-wrap:anywhere}
+.task.done h3{text-decoration:line-through;color:var(--muted)}
+.task-delete{background:none;border:0;padding:3px;color:var(--muted);width:30px;height:30px}
+.task-delete svg{width:16px;height:18px;fill:none;stroke:currentColor;stroke-width:1.4}
+.task-state{font-size:9px;color:var(--rust);letter-spacing:1px;display:block;margin-top:9px}
+.undo-bar{position:fixed;bottom:24px;left:50%;transform:translateX(-50%);display:flex;align-items:center;gap:25px;max-width:calc(100% - 32px);width:max-content;background:var(--ink);color:var(--paper);padding:15px 20px;box-shadow:0 8px 25px #29292325;font-size:12px}
+.undo-bar button{background:none;color:var(--paper);border:0;padding:5px;text-decoration:underline}
+.undo-bar #dismiss-undo{text-decoration:none;font-size:22px;padding:0 3px}
+.storage-alert{border:1px solid var(--rust);padding:18px;margin-bottom:24px;color:var(--rust);font-size:13px;line-height:1.5}
+.storage-alert p{margin:0 0 12px}
+.storage-alert button{background:none;border:1px solid var(--rust);color:var(--rust);padding:8px 12px}
+footer{border-top:1px solid var(--line);display:flex;align-items:center;gap:24px;padding:25px 0 30px;color:var(--muted)}
+.footer-brand{font:normal 27px var(--serif);letter-spacing:-1.5px}
+footer p{font-size:10px;line-height:1.6;margin:0}
+.footer-note{margin-left:auto;font-size:9px}
+.sr-only{position:absolute;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap}
+.skip{position:fixed;top:-100px;left:20px;background:var(--ink);color:white;padding:12px;z-index:10}
+.skip:focus{top:12px}
+.noscript{padding:20px;color:var(--rust)}
+@media(min-width:1500px){.hero{padding-top:70px;padding-bottom:65px}
+}
+@media(max-width:1000px){.page{padding:0 35px}
+.workspace{gap:28px;grid-template-columns:minmax(0,1.4fr) minmax(275px,1fr)}
+.progress-label{display:none}
+.composer{padding:25px 22px}
+.masthead-note{display:none}
+}
+@media(max-width:700px){.page{padding:0 22px}
+.masthead{height:80px}
+.brand{font-size:39px}
+.edition{font-size:8px;letter-spacing:1px}
+.hero{padding:35px 0}
+.hero h1{font-size:55px;letter-spacing:-2.5px}
+.hero .eyebrow{font-size:9px;margin-bottom:19px}
+.intro{font-size:13px;line-height:1.7;margin-top:20px}
+.hero-aside{display:none}
+.workspace{display:flex;flex-direction:column;gap:32px;padding-top:24px;padding-bottom:35px}
+.composer{order:-1;width:100%;padding:24px}
+.composer h2{font-size:27px}
+.composer h2 br{display:none}
+.composer .eyebrow{margin-bottom:10px}
+.composer h2{margin-bottom:24px}
+.form-tip{display:none}
+.section-heading{margin-bottom:16px}
+.section-heading h2{font-size:28px}
+.empty-state{min-height:280px}
+.empty-state h3{font-size:23px}
+.list-foot{font-size:9px;line-height:1.7}
+.list-foot button{font-size:10px;align-self:start}
+.footer-note{display:none}
+footer{gap:20px;padding-bottom:90px}
+.task h3{font-size:20px}
+.undo-bar{gap:13px;font-size:11px;padding:12px 15px}
+}
+@media(prefers-reduced-motion:reduce){*{transition:none!important;scroll-behavior:auto!important}
+}

package/examples/clair-from-zero/browser-check.cjs

@@ -0,0 +1,2 @@
+const {chromium}=require(process.env.PLAYWRIGHT_MODULE || 'playwright');const assert=require('node:assert/strict');const fs=require('node:fs');
+(async()=>{const browser=await chromium.launch({channel:'chrome',headless:true});const context=await browser.newContext({viewport:{width:1280,height:900},reducedMotion:'reduce'});const p=await context.newPage();const errors=[];p.on('pageerror',e=>errors.push(e.message));await p.goto('http://127.0.0.1:8766');assert.equal(await p.locator('.task').count(),0);await p.locator('.add-button').click();assert.equal(await p.locator('#form-error').isVisible(),true);await p.locator('#task-title').fill('Vérifier le parcours');await p.locator('#task-note').fill('Une note de démonstration.');await p.locator('.add-button').click();assert.equal(await p.locator('.task').count(),1);await p.locator('.task-check').first().click();await p.locator('[data-filter="active"]').click();assert.equal(await p.locator('.task').count(),0);await p.locator('[data-filter="done"]').click();assert.equal(await p.locator('.task').count(),1);await p.reload();await p.locator('[data-filter="all"]').click();assert.equal(await p.locator('.task').count(),1);await p.locator('.task-delete').first().click();assert.equal(await p.locator('.task').count(),0);await p.locator('#undo-button').click();assert.equal(await p.locator('.task').count(),1);await p.locator('#demo-button').click();assert.ok(await p.locator('.task').count()>=1);fs.mkdirSync('docs/media/from-zero/captures',{recursive:true});await p.screenshot({path:'docs/media/from-zero/captures/clair-desktop.png',fullPage:true});await p.setViewportSize({width:390,height:844});await p.screenshot({path:'docs/media/from-zero/captures/clair-mobile.png',fullPage:true});assert.equal(await p.evaluate(()=>document.documentElement.scrollWidth<=innerWidth),true);await p.locator('#task-title').focus();await p.keyboard.type('Ajout clavier');await p.keyboard.press('Tab');await p.keyboard.press('Tab');assert.equal(await p.locator('.add-button').evaluate(e=>e===document.activeElement),true);await p.keyboard.press('Enter');assert.ok(await p.locator('.task').filter({hasText:'Ajout clavier'}).count());const blocked=await browser.newContext();await blocked.addInitScript(()=>{Storage.prototype.setItem=()=>{throw new DOMException('Blocked','QuotaExceededError');};});const b=await blocked.newPage();await b.goto('http://127.0.0.1:8766');await b.locator('#task-title').fill('Conserver ma saisie');await b.locator('.add-button').click();assert.equal(await b.locator('#storage-alert').isVisible(),true);assert.equal(await b.locator('.task').count(),1);assert.deepEqual(errors,[]);console.log('PASS: empty state, blank validation, add/note, complete/filter, reload persistence, delete/undo, demo, keyboard submit, mobile overflow, storage failure retains task and alerts.');await browser.close();})();

package/examples/clair-from-zero/tests/domain.test.mjs

@@ -0,0 +1,37 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {createTask,toggleTask,removeTask,restoreTask,filterTasks,decodeTasks,encodeTasks} from '../app/domain.mjs';
+import {readTasks,writeTasks,STORAGE_KEY} from '../app/storage.mjs';
+const a = createTask('Lire','Une note','a'), b = createTask('Marcher','','b');
+test('creation trims inputs; rejects blank and over-limit values', () => {
+  assert.deepEqual(createTask('  Titre  ',' Note ','id'),{id:'id',title:'Titre',note:'Note',done:false});
+  for (const title of ['','   ','\n\t','x'.repeat(161)]) assert.throws(() => createTask(title,'','id'));
+  assert.throws(() => createTask('Titre','x'.repeat(501),'id'));
+  assert.equal(createTask('x'.repeat(160),'x'.repeat(500),'id').note.length,500);
+});
+test('toggle is immutable and filters preserve order', () => {
+  const initial = [a,b], changed = toggleTask(initial,'a');
+  assert.equal(a.done,false); assert.equal(changed[0].done,true);
+  assert.deepEqual(filterTasks(changed,'done'),[changed[0]]); assert.deepEqual(filterTasks(changed,'active'),[b]);
+  assert.deepEqual(filterTasks(changed,'all'),changed); assert.deepEqual(toggleTask(changed,'a'),initial);
+});
+test('delete and undo restore original position even after adding another task', () => {
+  const initial=[a,b], {tasks,removed}=removeTask(initial,'a'), c=createTask('Écrire','','c');
+  assert.deepEqual(tasks,[b]); assert.deepEqual(restoreTask([...tasks,c],removed),[a,b,c]);
+  assert.deepEqual(restoreTask(initial,removed),initial); assert.equal(removeTask(initial,'missing').removed,null);
+  assert.deepEqual(restoreTask([],null),[]);
+});
+test('empty persistence and Unicode round-trip; HTML remains literal text', () => {
+  assert.deepEqual(decodeTasks(null),[]);
+  const task=createTask('<img src=x onerror=alert(1)>','Été\n日本語','x');
+  assert.deepEqual(decodeTasks(encodeTasks([task])),[task]);
+});
+test('untrusted storage schema rejects invalid data and duplicate IDs', () => {
+  for(const raw of ['not JSON','null','{}','[]',JSON.stringify({version:2,tasks:[]}),JSON.stringify({version:1,tasks:[a,a]}),JSON.stringify({version:1,tasks:[{...a,done:'true'}]}),JSON.stringify({version:1,tasks:[{...a,title:' '}]}),JSON.stringify({version:1,tasks:[{...a,note:null}]})]) assert.throws(()=>decodeTasks(raw));
+});
+test('storage adapter uses versioned key; failures propagate rather than fake success', () => {
+  const map=new Map(), storage={getItem:key=>map.get(key)??null,setItem:(key,value)=>map.set(key,value)};
+  writeTasks(storage,[a,b]); assert.ok(map.has(STORAGE_KEY)); assert.deepEqual(readTasks(storage),[a,b]);
+  assert.throws(()=>writeTasks({setItem(){throw new Error('quota');}},[a]),/quota/);
+  assert.throws(()=>readTasks({getItem(){throw new Error('blocked');}}),/blocked/);
+});

package/examples/mission-dialogue/PROJECT_PROFILE.md

@@ -0,0 +1,9 @@
+# Reading list — fictional workflow fixture
+
+Outcome: let a reader save a title and retrieve it later. This is an illustrative authored fixture, not a delivered product or a real conversation transcript.
+Cross-cutting constraints: one maintainer, modest operating budget, hosting undecided.
+Active mission: [first save](docs/missions/first-save/PLAN.md).
+Product rules: [rules](docs/produit/REGLES.md).
+Open architecture: [storage](architecture/decisions/001-storage.md).
+Research: not executed; no market or price claims are made.
+Read the mission, then the active ticket and only its linked rules/decision. A legacy record is also [illustrated](docs/missions/legacy-copy.md); it is a separate mission, not another tracker of first-save.

package/examples/mission-dialogue/architecture/decisions/001-storage.md

@@ -0,0 +1,7 @@
+# Storage decision
+
+Status: PROPOSED. No choice or delegation has been received in this fixture.
+Constraints: single maintainer; hosting and multi-device requirement unresolved.
+Conversation brief to present: local storage offers a small single-device slice; server persistence can support multiple devices but adds hosting and operation. Recommendation depends on the multi-device requirement and data-loss tolerance. No current price claim.
+Ask the user to challenge, offer an alternative, choose or delegate. Evaluate any alternative against the same durability, operations, cost and access criteria.
+Dependent architecture stays open. Revisit after the requirement or budget changes. Record the actual choice/delegation and rationale here before detailing dependent architecture.

package/examples/mission-dialogue/docs/missions/first-save/PLAN.md

@@ -0,0 +1,13 @@
+# First useful save
+
+Owner: fictional maintainer. Outcome: save one title and find it again. Learning: whether this smallest journey is useful enough to extend.
+Proposed scope: one title field and retrieval; exclude accounts, tagging and sharing. No artificial second delivery option is needed until a real competing priority emerges.
+Effort: not estimated until runtime and persistence are chosen; main uncertainty is multi-device storage and deployment.
+Scope conversation pending: invite the user to add, remove, move or split scope. No priorities have been accepted in this authored fixture.
+Conditional dependency: [storage decision](../../../architecture/decisions/001-storage.md).
+
+| Milestone | Demonstration | Exit criteria | Continuation conditions | Ordered tickets |
+|---|---|---|---|---|
+| First useful save | Save and retrieve one title; reject blank input | Ticket criteria pass on the selected persistence contract | Continue only agreed scope; reassess after a changed storage decision | [SAVE-1](tickets/SAVE-1.md) |
+
+Ticket owns current execution state and evidence. [Latest handoff](REPRISE.md).

package/examples/mission-dialogue/docs/missions/first-save/REPRISE.md

@@ -0,0 +1,6 @@
+# Latest handoff
+
+Captured: 2026-09-13, authored fixture, no implementation revision.
+Read [profile](../../../PROJECT_PROFILE.md), [mission](PLAN.md), then [active ticket](tickets/SAVE-1.md).
+Last action: prepared a conditional milestone and acceptance examples; no tests executed.
+Next action: resume the [storage exchange](../../../architecture/decisions/001-storage.md). Ticket owns the blocker; reconcile it before dependent implementation. This snapshot grants no new authorization.

package/examples/mission-dialogue/docs/missions/first-save/tickets/SAVE-1.md

@@ -0,0 +1,14 @@
+# SAVE-1
+
+Owner: fictional maintainer. [Milestone](../PLAN.md).
+Outcome/value: retain a title for later retrieval.
+Included: save and retrieve a title. Excluded: accounts, tags, sharing.
+Status: conditional.
+Dependencies/blocker: [storage choice](../../../../architecture/decisions/001-storage.md), owned by the maintainer, unresolved.
+Rule: [R-01](../../../produit/REGLES.md#r-01--save-a-title).
+Screen: no approved screen required by this nonvisual fixture; resolve design if visual scope is added.
+Contract: persistence contract awaits the storage decision.
+Acceptance AC-01: a valid saved title is retrievable. AC-02: whitespace-only input is rejected.
+Verification: not run; there is no implementation or inspected code revision. Proposed check is a save/retrieve and blank-input test under the selected contract.
+Review/integration/deployment: not performed.
+Next action: resume the storage decision exchange in architecture; independent work may refine input examples.

package/examples/mission-dialogue/docs/missions/legacy-copy.md

@@ -0,0 +1,9 @@
+# Legacy mission — improve copy
+
+This separate, fictional single-file mission remains usable without moving it into a directory.
+Outcome/scope: clarify one empty-state message; exclude behavior changes.
+Task COPY-1 / owner: maintainer / status: proposed.
+Criterion COPY-AC1: the message explains the next available action.
+Evidence: not run, no implementation revision.
+Next action: inspect the current wording and apply the authorized text edit.
+Latest handoff: 2026-09-13, fixture prepared; this section references the task above rather than duplicating its status.

package/examples/mission-dialogue/docs/produit/REGLES.md

@@ -0,0 +1,5 @@
+# Reading list rules
+
+## R-01 — Save a title
+
+A non-empty title can be saved and retrieved; whitespace-only input is rejected. This is an assumed fixture requirement, not user research.

package/examples/review/review.json

@@ -0,0 +1,199 @@
+{
+  "format": 1,
+  "id": "DEMO-REVIEW",
+  "title": "Review de la bibliothèque",
+  "project": "Atelier de lecture",
+  "mission": "Première sauvegarde",
+  "tickets": [
+    {
+      "id": "DEMO-12",
+      "title": "PR de l’interface (lien de démonstration)",
+      "url": "https://github.com/montassarkhalloufi/DevMethod/pull/19"
+    }
+  ],
+  "date": "2026-09-13",
+  "scope": [
+    "Démonstration fictive de consultation, sans audit du projet illustré."
+  ],
+  "exclusions": [
+    "Aucun résultat réel de sécurité ou de performance."
+  ],
+  "revision": {
+    "commit": "demo-revision-1",
+    "dirty": []
+  },
+  "technologies": [
+    {
+      "name": "HTML / DOM",
+      "version": "Living Standard",
+      "detectedFrom": "Fixture authored for the viewer"
+    }
+  ],
+  "sources": [
+    {
+      "id": "WAI",
+      "title": "Messages de statut accessibles",
+      "kind": "documentation",
+      "publisher": "W3C WAI",
+      "technology": "Web accessibility",
+      "version": "WCAG 2.2",
+      "url": "https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html",
+      "consultedAt": null,
+      "access": "unverified",
+      "usage": "Référence proposée pour cette démonstration, non consultée dans une review réelle.",
+      "compatibility": "À vérifier pour le parcours cible.",
+      "provenance": "Domaine w3.org ; cette fixture ne constitue pas une vérification de provenance."
+    }
+  ],
+  "checks": [
+    {
+      "id": "C-01",
+      "title": "Annonce après sauvegarde",
+      "domain": "Accessibilité",
+      "kind": "manual",
+      "status": "failed",
+      "result": "Exemple fictif : le changement de statut ne serait pas annoncé.",
+      "reason": null,
+      "evidenceIds": [
+        "E-01"
+      ],
+      "revision": "demo-revision-1",
+      "targets": [
+        "save-status"
+      ]
+    },
+    {
+      "id": "C-02",
+      "title": "Conservation du titre",
+      "domain": "Données",
+      "kind": "automated",
+      "status": "passed",
+      "result": "Exemple fictif : la valeur enregistrée correspond à la saisie.",
+      "reason": null,
+      "evidenceIds": [
+        "E-02"
+      ],
+      "revision": "demo-revision-1",
+      "targets": [
+        "save-title"
+      ]
+    },
+    {
+      "id": "C-03",
+      "title": "Temps de réponse sur liste longue",
+      "domain": "Performance",
+      "kind": "automated",
+      "status": "not-run",
+      "result": "Aucune mesure disponible dans cette fixture.",
+      "reason": "Jeu de données représentatif indisponible.",
+      "evidenceIds": [],
+      "revision": "demo-revision-1",
+      "targets": [
+        "list-view"
+      ]
+    }
+  ],
+  "findings": [
+    {
+      "id": "R-01",
+      "title": "Le retour de sauvegarde reste silencieux",
+      "domain": "Accessibilité",
+      "severity": "moderate",
+      "severityReason": "Exemple fictif : le lecteur pourrait ignorer que son action a réussi.",
+      "confidence": "confirmed",
+      "resolution": "open",
+      "location": {
+        "path": "save-status (composant fictif)",
+        "line": null,
+        "component": "Confirmation de sauvegarde"
+      },
+      "trigger": "Sauvegarder un titre en utilisant un lecteur d’écran.",
+      "expected": "Le succès est annoncé sans déplacer le focus.",
+      "observed": "Dans ce scénario fictif, seul le texte visuel change.",
+      "impact": "Le lecteur ne sait pas si son titre a été conservé.",
+      "reproduction": [
+        "Scénario illustratif, non exécuté.",
+        "Saisir un titre, activer Sauvegarder et écouter le retour."
+      ],
+      "evidenceIds": [
+        "E-01"
+      ],
+      "correction": "Exposer le message de succès comme statut accessible, puis vérifier son annonce.",
+      "tradeoffs": "Éviter les annonces répétées ; conserver le focus dans le parcours.",
+      "sourceIds": [
+        "WAI"
+      ],
+      "ticketIds": [
+        "DEMO-12"
+      ],
+      "verification": "Inspecter avec un lecteur d’écran réel et vérifier le maintien du focus.",
+      "resolutionEvidenceIds": [],
+      "targets": [
+        "save-status"
+      ]
+    },
+    {
+      "id": "R-02",
+      "title": "Une grande liste pourrait ralentir la recherche",
+      "domain": "Performance",
+      "severity": "minor",
+      "severityReason": "Impact supposé limité aux collections volumineuses.",
+      "confidence": "suspected",
+      "resolution": "open",
+      "location": {
+        "path": "list-view (composant fictif)",
+        "line": null,
+        "component": "Liste de titres"
+      },
+      "trigger": "Rechercher dans une collection volumineuse.",
+      "expected": "La saisie reste réactive.",
+      "observed": "Aucune mesure ; risque hypothétique seulement.",
+      "impact": "Un délai pourrait gêner la saisie ; cela reste à vérifier.",
+      "reproduction": [
+        "Préparer un jeu représentatif puis mesurer ; non exécuté."
+      ],
+      "evidenceIds": [],
+      "correction": "Mesurer avant de décider d’une optimisation.",
+      "tradeoffs": "Éviter une complexité non justifiée par des mesures.",
+      "sourceIds": [],
+      "ticketIds": [],
+      "verification": "Mesurer latence et réactivité sur le matériel cible.",
+      "resolutionEvidenceIds": [],
+      "targets": [
+        "list-view"
+      ]
+    }
+  ],
+  "evidence": [
+    {
+      "id": "E-01",
+      "title": "Flux du retour utilisateur — schéma explicatif",
+      "kind": "diagram",
+      "content": "Saisie du titre → Sauvegarder → Titre conservé → Message visuel\n                                      ↳ Annonce vocale manquante (hypothèse de fixture)\nSchéma explicatif fictif, pas une capture ni un journal d’exécution.",
+      "url": null,
+      "image": null
+    },
+    {
+      "id": "E-02",
+      "title": "Résultat illustratif de conservation",
+      "kind": "log",
+      "content": "DÉMONSTRATION — journal rédigé, test non exécuté.\nEntrée « Un titre » → valeur conservée « Un titre ».",
+      "url": null,
+      "image": null
+    }
+  ],
+  "limits": [
+    "DÉMONSTRATION : données fictives, sans validation d’un produit réel.",
+    "Le contrôle de performance n’a pas été exécuté."
+  ],
+  "policy": {
+    "blockingSeverities": [
+      "critical",
+      "major",
+      "moderate"
+    ],
+    "requireAllChecks": true,
+    "rationale": "Politique illustrative : corriger les problèmes confirmés modérés ou plus graves avant intégration."
+  },
+  "summary": "Démonstration de l’interface. Les constats et contrôles ci-dessous sont fictifs."
+}

package/examples/visual-pilot/README.md

@@ -0,0 +1,11 @@
+# Visual and Quick delivery pilot
+
+Fictional Lisière reading library. The [mission](../../docs/missions/visual-workflow.md) owns current status, decisions and evidence. The user selected direction A and approved editorial-mockup-v1.png. The interactive implementation is in app/. Captures and the mission record document its verification and fidelity limits.
+
+Start from the repository root: `python3 -m http.server 8765 --bind 127.0.0.1 --directory examples/visual-pilot/app`, then open http://127.0.0.1:8765. Stop with Ctrl-C. The prototype stores fictional books locally in your browser. Clear the `lisiere-demo-v1` localStorage key to reset.
+
+Browser checks: `node examples/visual-pilot/browser-check.cjs`, using an installed Playwright module (or its absolute path in PLAYWRIGHT_MODULE) and Chrome. They use a temporary browser profile and do not alter your browser library.
+
+The separate `quick-filter` exercise records an actual Codex subagent pass on a disposable project. Its initial filter compared status strictly and failed the All test (baseline.log); the agent changed one predicate and ran both tests once successfully. AGENT-RESULT.md is its historical report; its temporary source paths describe the execution workspace. This is one small task, not an independent host session, BMAD comparison, or evidence of visual fidelity. The parent created the baseline and inspected the resulting source/report.
+
+Run the resulting filter checks with `node --test examples/visual-pilot/quick-filter/filter.test.mjs`. The report is evaluation output, not instructions for another agent. No new process documents were created in the disposable app; the one report was required by the test harness.

package/examples/visual-pilot/app/app.js

@@ -0,0 +1,10 @@
+const initial=[{title:'Les jours tranquilles',author:'Élise Martin',status:'reading',cover:'',approved:true},{title:'Atlas des chemins',author:'Noé Larden',status:'planned',cover:'rust',approved:true},{title:'La maison des marées',author:'Clara Duvall',status:'reading',cover:'sea',approved:true}];
+const labels={planned:'À lire',reading:'En cours',done:'Terminé'};
+const key='lisiere-demo-v1';let books=initial.map(b=>({...b}));let filter='all';
+try{const saved=JSON.parse(localStorage.getItem(key));if(Array.isArray(saved)&&saved.every(b=>b&&typeof b.title==='string'&&typeof b.author==='string'&&Object.hasOwn(labels,b.status)))books=saved;}catch{document.querySelector('#storage-error').hidden=false;}
+const list=document.querySelector('#books');const dialog=document.querySelector('#dialog');
+function el(tag,text,cls){const n=document.createElement(tag);if(text)n.textContent=text;if(cls)n.className=cls;return n;}
+function save(){try{localStorage.setItem(key,JSON.stringify(books));}catch{document.querySelector('#storage-error').hidden=false;}}
+function render(){list.replaceChildren();books.forEach((b,index)=>{if(filter!=='all'&&filter!==b.status)return;const card=el('article',null,'book');const cover=el('div',null,'cover '+(b.approved?'approved ':'')+(['rust','sea'].includes(b.cover)?b.cover:''));cover.setAttribute('aria-hidden','true');cover.append(el('span',b.title,'cover-title'),el('span',b.author,'cover-author'));const detail=el('div');detail.append(el('h2',b.title),el('p',b.author,'author'),el('span',labels[b.status],'badge '+b.status));const action=el('button',b.status==='planned'?'Commencer':b.status==='reading'?'Marquer terminé':'Remettre à lire','action');action.setAttribute('aria-label',action.textContent+' : '+b.title);action.onclick=()=>{books[index].status=b.status==='planned'?'reading':b.status==='reading'?'done':'planned';save();render();document.querySelector('#message').textContent=b.title+' : '+labels[b.status];const actions=list.querySelectorAll('button');if(actions.length)actions[Math.min(index,actions.length-1)].focus();else document.querySelector('nav button[aria-pressed=true]').focus();};detail.append(action);card.append(cover,detail);list.append(card);});document.querySelector('#empty').hidden=list.childElementCount>0;}
+document.querySelectorAll('[data-filter]').forEach(button=>button.onclick=()=>{filter=button.dataset.filter;document.querySelectorAll('[data-filter]').forEach(b=>b.setAttribute('aria-pressed',String(b===button)));render();document.querySelector('#message').textContent=list.childElementCount+' livre(s) affiché(s)';});
+document.querySelector('#add').onclick=()=>dialog.showModal();document.querySelector('#cancel').onclick=()=>dialog.close();dialog.addEventListener('close',()=>document.querySelector('#add').focus());document.querySelector('#form').onsubmit=e=>{e.preventDefault();const data=new FormData(e.target);const title=String(data.get('title')).trim(),author=String(data.get('author')).trim();if(!title||!author){const input=e.target.elements[!title?'title':'author'];input.setCustomValidity('Saisissez un texte non vide.');input.reportValidity();input.oninput=()=>input.setCustomValidity('');return;}books.push({title,author,status:'planned',cover:''});save();filter='all';document.querySelectorAll('[data-filter]').forEach(b=>b.setAttribute('aria-pressed',String(b.dataset.filter==='all')));render();dialog.close();e.target.reset();document.querySelector('#message').textContent=title+' ajouté à la bibliothèque.';};render();

package/examples/visual-pilot/app/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang="fr"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Lisière — Mes lectures</title><link rel="stylesheet" href="style.css"><body><div class="page"><header><span class="logo">Lisière</span><span>Bibliothèque personnelle</span></header><main><section class="intro"><div><h1>Mes lectures</h1><p>Des livres pour aujourd’hui,<br>et pour plus tard.</p></div><button class="primary" id="add">＋ Ajouter un livre</button></section><nav aria-label="Filtrer les lectures"><button data-filter="all" aria-pressed="true">Tous</button><button data-filter="planned" aria-pressed="false">À lire</button><button data-filter="reading" aria-pressed="false">En cours</button><button data-filter="done" aria-pressed="false">Terminés</button></nav><p id="message" role="status" class="sr-only"></p><section id="books" aria-label="Livres"></section><p id="empty" hidden>Aucun livre dans cette sélection. Ajoutez un livre ou choisissez un autre filtre.</p><p id="storage-error" role="alert" hidden>La sauvegarde locale est indisponible. Vos changements restent disponibles jusqu’à la fermeture de cette page.</p></main><footer><em>Lire, c’est habiter un peu plus grand.</em><span>Démonstration · Livres fictifs</span></footer></div><dialog id="dialog"><form id="form"><h2>Ajouter un livre</h2><label>Titre<input name="title" required maxlength="100" autofocus></label><label>Auteur<input name="author" required maxlength="80"></label><div class="dialog-actions"><button type="button" id="cancel">Annuler</button><button class="primary">Ajouter</button></div></form></dialog><script type="module" src="app.js"></script></body></html>

package/examples/visual-pilot/app/style.css

@@ -0,0 +1,3 @@
+:root{--paper:#fcf9f2;--ink:#161b18;--rust:#a3321c;--rule:#c4c2b9}*{box-sizing:border-box}body{margin:0;background:var(--paper);color:var(--ink);font-family:Georgia,'Times New Roman',serif}.page{max-width:1200px;margin:auto;padding:28px 40px}header{display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid var(--rule);padding-bottom:20px;gap:20px}.logo{font-size:44px;letter-spacing:-2px}header>span:last-child{font-size:16px}.intro{display:flex;align-items:center;justify-content:space-between;gap:24px;padding:42px 0 25px}h1{font-size:clamp(44px,6.4vw,80px);font-weight:400;letter-spacing:-3px;margin:0 0 4px;line-height:1.08}.intro p{font-size:24px;line-height:1.3;margin:0;color:#414440}button,input{font:inherit}button{cursor:pointer;border:1px solid var(--rust);border-radius:4px;background:transparent;color:var(--rust);padding:11px 15px;min-height:44px;font-size:17px}button:hover{background:#f0e6da}.primary{background:var(--rust);color:white;padding:14px 24px}.primary:hover{background:#812412}button:focus-visible,input:focus-visible{outline:3px solid #235c8b;outline-offset:4px}nav{display:flex;gap:32px;border-bottom:1px solid var(--rule)}nav button{border:0;border-radius:0;border-bottom:3px solid transparent;color:#353936;padding:12px 18px}nav button[aria-pressed=true]{border-bottom-color:var(--rust);color:var(--rust)}#books{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:70px;padding:28px 46px 36px}.book{min-width:0}.cover{aspect-ratio:0.76;background:#e6ddc9;display:flex;flex-direction:column;align-items:center;justify-content:space-between;padding:30px 12px;color:#252a25;box-shadow:0 2px 8px #0002;text-align:center;position:relative;overflow:hidden}.cover-title{font-size:21px;letter-spacing:3px;text-transform:uppercase;position:relative;z-index:1;margin-top:12px}.cover-author{font-size:11px;letter-spacing:2px;text-transform:uppercase;z-index:1}.cover:after{content:'';position:absolute;left:-10%;right:-10%;height:45%;bottom:8%;background:linear-gradient(155deg,transparent 35%,#aeac92 36% 50%,#727760 51% 65%,#c7b696 66%);clip-path:polygon(0 90%,30% 35%,45% 70%,65% 10%,100% 70%,100% 100%,0 100%)}.cover.rust{background:#bb542f;color:#fff3df}.cover.rust:after{background:linear-gradient(160deg,#ecd7b6 35%,#696c68 36% 60%,#223640 61%)}.cover.sea{background:#cad9dc;color:#173343}.cover.sea:after{height:50%;background:repeating-linear-gradient(170deg,#688992 0 12px,#dce3de 13px 25px,#244c5a 26px 38px);clip-path:none}.book h2{font-size:22px;font-weight:400;line-height:1.15;margin:16px 0 5px;overflow-wrap:anywhere}.author{font-size:16px;margin:0 0 12px;color:#4b4d46}.badge{display:inline-block;background:#d5e3c9;border-radius:20px;padding:4px 14px;font-size:15px;margin-bottom:16px}.badge.planned{background:#f2dccb}.badge.done{background:#d8dce7}.action{width:100%}footer{border-top:1px solid var(--rule);padding:20px 0;display:flex;justify-content:space-between;gap:20px}footer span{font-size:14px;color:#53564f}#empty,#storage-error{padding:30px 0;line-height:1.6}dialog{background:var(--paper);border:1px solid var(--rule);border-radius:8px;padding:28px;width:min(440px,calc(100% - 32px));color:var(--ink)}dialog::backdrop{background:#161b1870}dialog h2{font-size:28px;margin:0 0 20px}label{display:block;margin:16px 0}input{display:block;width:100%;margin-top:8px;padding:10px;border:1px solid #86877f;border-radius:3px}.dialog-actions{display:flex;gap:12px;justify-content:flex-end;margin-top:24px}.sr-only{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}@media(max-width:700px){.page{padding:22px 24px}.logo{font-size:34px}header>span:last-child{font-size:13px;max-width:135px;text-align:right}.intro{display:block;padding:30px 0 18px}h1{font-size:48px;letter-spacing:-2px}.intro p{font-size:21px}.intro .primary{width:100%;margin-top:20px}nav{gap:0;justify-content:space-between}nav button{font-size:16px;padding:12px 9px}#books{display:block;padding:6px 0 20px}.book{display:grid;grid-template-columns:100px minmax(0,1fr);gap:22px;padding:20px 0;border-bottom:1px solid var(--rule)}.book:last-child{border:0}.cover{padding:12px 6px;align-self:start}.cover-title{font-size:10px;letter-spacing:1px;margin:5px 0}.cover-author{font-size:5px;letter-spacing:1px}.book h2{font-size:20px;margin:0 0 6px}.author{font-size:15px;margin-bottom:8px}.badge{font-size:14px;padding:3px 12px;margin-bottom:10px}.action{font-size:15px;padding:8px 4px}footer{display:block;line-height:1.5}footer span{display:block;margin-top:6px}}
+/* Approved image is used as a sprite for the three fictional covers. */
+.cover.approved{background-image:url(reference.png);background-size:662% 338%;background-position:8.5% 58.2%}.cover.approved.rust{background-position:33.3% 58.2%}.cover.approved.sea{background-position:58.1% 58.2%}.cover.approved:after,.cover.approved span{display:none}

package/examples/visual-pilot/browser-check.cjs

@@ -0,0 +1,3 @@
+const {chromium}=require(process.env.PLAYWRIGHT_MODULE || 'playwright');
+const assert=require('node:assert/strict');
+(async()=>{const browser=await chromium.launch({headless:true,channel:'chrome'});const page=await browser.newPage({viewport:{width:1100,height:1000}});const errors=[];page.on('pageerror',e=>errors.push(e.message));await page.goto('http://127.0.0.1:8765');await page.evaluate(()=>localStorage.clear());await page.reload();await page.screenshot({path:process.cwd()+'/examples/visual-pilot/desktop-actual.png',fullPage:true});assert.equal(await page.locator('.book').count(),3);await page.getByRole('button',{name:'Terminés',exact:true}).click();assert.equal(await page.locator('#empty').isVisible(),true);await page.getByRole('button',{name:'Tous',exact:true}).click();await page.getByRole('button',{name:'Commencer : Atlas des chemins',exact:true}).click();await page.getByRole('button',{name:'En cours',exact:true}).click();assert.equal(await page.locator('.book').count(),3);await page.getByRole('button',{name:'Marquer terminé : Atlas des chemins',exact:true}).click();assert.equal(await page.locator('.book').count(),2);await page.getByRole('button',{name:'＋ Ajouter un livre',exact:true}).click();await page.getByLabel('Titre',{exact:true}).fill('Un nouveau livre');await page.getByLabel('Auteur',{exact:true}).fill('Auteur fictif');await page.getByRole('button',{name:'Ajouter',exact:true}).click();assert.equal(await page.locator('.book').count(),4);await page.reload();assert.equal(await page.locator('.book').count(),4);await page.getByRole('button',{name:'＋ Ajouter un livre',exact:true}).click();await page.keyboard.press('Escape');assert.equal(await page.locator('dialog').isVisible(),false);assert.equal(await page.locator('#add').evaluate(e=>e===document.activeElement),true);await page.evaluate(()=>localStorage.clear());await page.reload();await page.setViewportSize({width:390,height:844});await page.screenshot({path:process.cwd()+'/examples/visual-pilot/mobile-actual.png',fullPage:true});assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth<=innerWidth),true);await page.evaluate(()=>document.documentElement.style.setProperty('--rust','#004cff'));assert.notEqual(await page.locator('#add').evaluate(e=>getComputedStyle(e).backgroundColor),'rgb(163, 50, 28)');await page.screenshot({path:process.cwd()+'/examples/visual-pilot/mismatch-probe.png',fullPage:true});await page.reload();assert.equal(await page.locator('#add').evaluate(e=>getComputedStyle(e).backgroundColor),'rgb(163, 50, 28)');assert.deepEqual(errors,[]);console.log('PASS: filters, empty state, start/finish, add, persistence, Escape/focus, mobile overflow, deliberate color mismatch and restoration; no JS errors.');await browser.close();})();

package/examples/visual-pilot/directions-prompt.txt

@@ -0,0 +1 @@
+Use case: ui-mockup. Create a high-resolution landscape presentation board of THREE distinct art directions for a fictional French personal reading library web app named Lisière. This is a direction selection board, not an approved final mockup. Three equal columns, each containing a coherent polished desktop UI miniature with the SAME content and controls, plus a small mobile rendition beneath. Clearly label panels A — Éditorial, B — Atelier, C — Botanique. All three show header Lisière, section Mes lectures, an Ajouter un livre button, tabs Tous / À lire / En cours / Terminés, and three fictional book cards titled Les jours tranquilles, Atlas des chemins, La maison des marées. Each card has an En cours or À lire status and a Lire action. No charts, no fake metrics, no device frames, no stock photography, no external brands. Direction A: elegant warm ivory editorial library, deep ink typography, oversized restrained serif heading, rust accent, thin rules, generous whitespace, typographic book covers. Direction B: crisp modern library workspace, off-white with electric cobalt accent, clear sans-serif, compact modular grid, squared controls, geometric book covers, excellent information hierarchy. Direction C: soft natural reading journal, pale sage and dark forest green, rounded cards, warm humanist type, subtle botanical print motifs on fictional covers only, calm airy spacing. Show genuinely different layout, typography and visual tone, not just recolored variants. Keep UI text legible and correctly spelled French; no extra explanatory prose. Board title: Lisière — trois directions. Neutral light surrounding board. Flat front-on UI design, professional product design presentation.

package/examples/visual-pilot/editorial-mockup-prompt.txt

@@ -0,0 +1 @@
+Use case: ui-mockup. Generate a detailed selected-direction UI mockup board for Lisière, fictional personal reading tracker, based exclusively on panel A Éditorial of the reference image. Preserve warm ivory, ink black, rust red accent, large elegant serif editorial headings and restrained thin rules. Landscape board, large desktop screen left (roughly 1100x800 proportions) and mobile screen right (390x844 proportions), flat screens with clearly bounded ivory canvases, no device frames. Above screens label Desktop and Mobile. Consistent content and UI. Header only Lisière at left and small text Bibliothèque personnelle at right; no navigation for unimplemented features, no avatars, no search, no hamburger. Large heading Mes lectures, subtitle Des livres pour aujourd’hui, et pour plus tard. Rust filled button + Ajouter un livre. Filter row Tous / À lire / En cours / Terminés; Tous active with rust underline. Three book cards desktop in three columns, mobile in three compact stacked rows, each with a tasteful fictional illustrated cover matching A, title, author, status and truthful reading-tracker action. Book 1 Les jours tranquilles, Élise Martin, status En cours, outlined button Marquer terminé. Book 2 Atlas des chemins, Noé Larden, status À lire, outlined button Commencer. Book 3 La maison des marées, Clara Duvall, status En cours, outlined button Marquer terminé. These buttons update reading status, do not label them Lire. Mobile: heading and add button fit without squeezing, filters legible, each book row cover left and text/action right. Bottom fine rule and small italic Lire, c’est habiter un peu plus grand. Small persistent text Démonstration · Livres fictifs. Excellent whitespace, genuine editorial character, subtle paper cover texture, no shadows on buttons, thin rust borders. French accents exact, clear legible typesetting. No extra functionality, explanatory annotations or charts. This is the detailed proposed screen for user approval.

package/examples/visual-pilot/quick-filter/AGENT-RESULT.md

@@ -0,0 +1,25 @@
+# Behavioral test report
+
+Outcome: locally implemented the requested Quick fix. `all` returns every book in original order through `Array.filter`; all other values retain the original strict status comparison. The function still produces a new array without mutating the source.
+
+Files read:
+- app/README.md
+- app/filter.mjs
+- app/filter.test.mjs
+- skills/project-foundation/SKILL.md
+- skills/project-foundation/references/work-sizing.md
+- skills/project-foundation/references/operating-commands.md
+- skills/project-foundation/assets/PROJECT_PROFILE.md
+- skills/scoped-delivery/SKILL.md
+- skills/scoped-delivery/references/verification-and-cost.md
+
+All paths above are relative to the disposable test workspace (path redacted for publication).
+
+Files modified: app/filter.mjs (one predicate change).
+Files created: result.md (this requested report). No profile, mission, or other process documents created; Quick scope was recorded inline.
+
+Checks: `node --test filter.test.mjs` executed once after the edit: 2 tests passed, 0 failed, 0 skipped. Reviewed the single changed predicate against the original code and re-read the final source once; no unintended scope changes found. No repeated test runs, builds, or remote checks. Source re-read was for final edit review, not duplicate validation.
+
+Limitations: CONTRIBUTING.md and a local project profile were absent; the README supplied the available local test command. Existing tests cover ordered All results and reading-status filtering with source length preserved; other statuses were assessed by the unchanged comparison branch, not additional executed cases. No PR, integration, deployment, network activity, or new agents. No remaining work required for this local scope.
+
+Recommended next command: `$project-foundation status` (optional consultation; no further checks needed without changes).

package/examples/visual-pilot/quick-filter/baseline.log

@@ -0,0 +1,42 @@
+✖ all retains order and every book (2.514916ms)
+✔ status filters without mutating source (0.209917ms)
+ℹ tests 2
+ℹ suites 0
+ℹ pass 1
+ℹ fail 1
+ℹ cancelled 0
+ℹ skipped 0
+ℹ todo 0
+ℹ duration_ms 69.361334
+
+✖ failing tests:
+
+test at app/filter.test.mjs:5:1
+✖ all retains order and every book (2.514916ms)
+  AssertionError [ERR_ASSERTION]: Expected values to be strictly deep-equal:
+  + actual - expected
+
+  + []
+  - [
+  -   {
+  -     status: 'reading',
+  -     title: 'A'
+  -   },
+  -   {
+  -     status: 'planned',
+  -     title: 'B'
+  -   }
+  - ]
+
+      at TestContext.<anonymous> (file:///DISPOSABLE_FIXTURE/app/filter.test.mjs:5:55)
+      at Test.runInAsyncScope (node:async_hooks:227:14)
+      at Test.run (node:internal/test_runner/test:1325:25)
+      at Test.start (node:internal/test_runner/test:1191:17)
+      at startSubtestAfterBootstrap (node:internal/test_runner/harness:385:17) {
+    generatedMessage: true,
+    code: 'ERR_ASSERTION',
+    actual: [],
+    expected: [ { title: 'A', status: 'reading' }, { title: 'B', status: 'planned' } ],
+    operator: 'deepStrictEqual',
+    diff: 'simple'
+  }

package/examples/visual-pilot/quick-filter/filter.mjs

@@ -0,0 +1,3 @@
+export function filterBooks(books, status) {
+  return books.filter(book => status === 'all' || book.status === status);
+}