devmethod-ai 0.1.0-rc.2 → 0.2.0

package/evaluation/greenfield/acceptance.test.mjs

@@ -0,0 +1,57 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {pathToFileURL} from 'node:url';
+const project=path.resolve(process.env.PROJECT_DIR || 'examples/pocket-tasks');
+const {createTaskServer}=await import(pathToFileURL(path.join(project,'server.mjs')));
+const start=async dataFile=>{const server=createTaskServer({dataFile});await new Promise((resolve,reject)=>{server.once('error',reject);server.listen(0,'127.0.0.1',resolve);});return {server,url:`http://127.0.0.1:${server.address().port}`};};
+const close=server=>new Promise((resolve,reject)=>{server.close(error=>error?reject(error):resolve());server.closeIdleConnections?.();});
+
+test('independent greenfield contract',async t=>{
+ const dir=fs.mkdtempSync(path.join(fs.realpathSync(os.tmpdir()),'pocket-acceptance-'));
+ const dataFile=path.join(dir,'tasks.json');let app=await start(dataFile);
+ t.after(async()=>{await close(app.server);fs.rmSync(dir,{recursive:true,force:true});});
+ const request=(route,method='GET',body)=>fetch(app.url+route,{method,...(body===undefined?{}:{headers:{'content-type':'application/json'},body:JSON.stringify(body)})});
+ let id;
+ await t.test('new app starts empty, creates trimmed task and persists fields',async()=>{
+  assert.deepEqual(await (await request('/api/tasks')).json(),{tasks:[]});
+  const response=await request('/api/tasks','POST',{title:'  Plan the demo  '});assert.equal(response.status,201);
+  const {task}=await response.json();assert.equal(task.title,'Plan the demo');assert.equal(task.done,false);assert.equal(typeof task.id,'string');assert.ok(task.id);id=task.id;
+ });
+ await t.test('edits, completes, reopens and handles missing IDs',async()=>{
+  let response=await request('/api/tasks/'+id,'PATCH',{title:'Ship the demo',done:true});assert.equal(response.status,200);assert.deepEqual((await response.json()).task,{id,title:'Ship the demo',done:true});
+  response=await request('/api/tasks/'+id,'PATCH',{done:false});assert.equal((await response.json()).task.done,false);
+  assert.equal((await request('/api/tasks/missing','PATCH',{done:true})).status,404);
+  assert.equal((await request('/api/tasks/missing','DELETE')).status,404);
+ });
+ await t.test('invalid inputs and malformed JSON are rejected without mutations',async()=>{
+  const before=await (await request('/api/tasks')).json();
+  for(const body of [null,[],{}, {title:''},{title:'   '},{title:12},{title:'x'.repeat(121)}])assert.equal((await request('/api/tasks','POST',body)).status,400,JSON.stringify(body));
+  for(const body of [null,[],{}, {done:'yes'},{title:null}])assert.equal((await request('/api/tasks/'+id,'PATCH',body)).status,400,JSON.stringify(body));
+  const malformed=await fetch(app.url+'/api/tasks',{method:'POST',headers:{'content-type':'application/json'},body:'{broken'});assert.equal(malformed.status,400);assert.ok(await malformed.json());
+  const large=await request('/api/tasks','POST',{title:'x'.repeat(17000)});assert.equal(large.status,413);
+  assert.deepEqual(await (await request('/api/tasks')).json(),before);
+ });
+ await t.test('concurrent writes preserve unique tasks and literal HTML-looking text',async()=>{
+  const results=await Promise.all(Array.from({length:12},(_,i)=>request('/api/tasks','POST',{title:'Parallel '+i})));
+  assert.ok(results.every(r=>r.status===201));
+  const literal='<img src=x onerror=alert(1)>';const response=await request('/api/tasks','POST',{title:literal});assert.equal(response.status,201);assert.equal((await response.json()).task.title,literal);
+  const {tasks}=await (await request('/api/tasks')).json();assert.equal(tasks.length,14);assert.equal(new Set(tasks.map(t=>t.id)).size,14);
+ });
+ await t.test('restart restores data and delete persists',async()=>{
+  const before=await (await request('/api/tasks')).json();await close(app.server);app=await start(dataFile);assert.deepEqual(await (await request('/api/tasks')).json(),before);
+  assert.equal((await request('/api/tasks/'+id,'DELETE')).status,204);await close(app.server);app=await start(dataFile);assert.equal((await (await request('/api/tasks')).json()).tasks.length,13);
+ });
+ await t.test('serves a UI and protects nonpublic sources',async()=>{
+  const page=await request('/');assert.equal(page.status,200);assert.match(page.headers.get('content-type'),/text\/html/);
+  assert.equal((await request('/server.mjs')).status,404);assert.equal((await request('/BRIEF.md')).status,404);assert.equal((await request('/api/unknown')).status,404);
+ });
+ await t.test('malformed stored data never silently resets',async()=>{
+  const corrupt=path.join(dir,'corrupt.json');fs.writeFileSync(corrupt,'not-json');let bad;
+  try{bad=await start(corrupt);}catch(error){assert.ok(error instanceof Error);}
+  if(bad){try{const response=await fetch(bad.url+'/api/tasks');assert.equal(response.status,500);}finally{await close(bad.server);}}
+  assert.equal(fs.readFileSync(corrupt,'utf8'),'not-json');
+ });
+});

package/evaluation/greenfield/security.test.mjs

@@ -0,0 +1,28 @@
+import test from 'node:test';
+import {request as rawRequest} from 'node:http';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {pathToFileURL} from 'node:url';
+const project=path.resolve(process.env.PROJECT_DIR || 'examples/pocket-tasks');
+const {createTaskServer}=await import(pathToFileURL(path.join(project,'server.mjs')));
+test('independent origin, host and media-type non-mutation checks',async t=>{
+ const dir=fs.mkdtempSync(path.join(fs.realpathSync(os.tmpdir()),'pocket-trust-'));const server=createTaskServer({dataFile:path.join(dir,'tasks.json')});
+ await new Promise(resolve=>server.listen(0,'127.0.0.1',resolve));const url=`http://127.0.0.1:${server.address().port}`;
+ t.after(async()=>{await new Promise(resolve=>{server.close(resolve);server.closeIdleConnections?.();});fs.rmSync(dir,{recursive:true,force:true});});
+ const send=headers=>new Promise((resolve,reject)=>{
+  const req=rawRequest(url+'/api/tasks',{method:'POST',headers},response=>{response.resume();response.on('end',()=>resolve({status:response.statusCode}));});
+  req.on('error',reject);if(headers.host)assert.equal(req.getHeader('host'),headers.host);req.end(JSON.stringify({title:'Rejected mutation'}));
+ });
+ for(const headers of [
+  {origin:'https://untrusted.example','content-type':'text/plain'},
+  {origin:'https://untrusted.example','content-type':'application/json'},
+  {origin:'null','content-type':'application/json'},
+  {'sec-fetch-site':'cross-site','content-type':'application/json'},
+  {host:`untrusted.example:${server.address().port}`,'content-type':'application/json'}
+ ])assert.equal((await send(headers)).status,403,JSON.stringify(headers));
+ assert.equal((await send({'content-type':'text/plain'})).status,415);
+ assert.deepEqual(await (await fetch(url+'/api/tasks')).json(),{tasks:[]});
+ assert.equal((await send({origin:url,'content-type':'application/json'})).status,201);
+});

package/evaluation/native-pilot-results.json

@@ -0,0 +1,155 @@
+{
+  "format": 1,
+  "kind": "bounded-native-pilot",
+  "runs": [
+    {
+      "id": "b1-1-none",
+      "status": "exited",
+      "objectiveChecksPassed": true,
+      "usage": {
+        "inputTokens": 79088,
+        "outputTokens": 953,
+        "cachedInputTokens": 69888,
+        "costUSD": null
+      },
+      "elapsedSeconds": 43.715,
+      "review": "Calibration only; excluded from comparison due to changed isolation settings. Independently rechecked.",
+      "evidenceSha256": {
+        "-setup.json": "8877dd507461b0f08a872da89bf4bc969625bcd1fc5ba8d75d8e9e8ce054fa48",
+        ".jsonl": "8f359c452ca399d82a10bd2d67df5eb930851c2104f5782c294f7d1035b636a2",
+        ".stderr": "a7886594c2ac648cf3565b765315daac7bda8ded4489c3d1d7cd92c75c941699"
+      }
+    },
+    {
+      "id": "matched-b1-1-bmad",
+      "status": "exited",
+      "objectiveChecksPassed": false,
+      "usage": {
+        "inputTokens": 36722,
+        "outputTokens": 435,
+        "cachedInputTokens": 23936,
+        "costUSD": null
+      },
+      "elapsedSeconds": 28.574,
+      "review": "Incomplete: no changes or handoff; tests fail. Worker reports UV/temp blocker, but no UV invocation is present in retained transcript; cause unconfirmed.",
+      "evidenceSha256": {
+        "-setup.json": "0be207640ca9e8d5277deb4e4d7f89726c50239defbc1d3bf7ba5df148495e7d",
+        ".jsonl": "37fb256063e991fb0b388e94474c181ba8524fd98ed1660388b87317cc6ecb40",
+        ".stderr": "45f6aa7228724ae1d9c42884f37b2b5cecc0429986b35c49550b410af857926c"
+      }
+    },
+    {
+      "id": "matched-b1-1-devmethod",
+      "status": "exited",
+      "objectiveChecksPassed": true,
+      "usage": {
+        "inputTokens": 134616,
+        "outputTokens": 1853,
+        "cachedInputTokens": 120192,
+        "costUSD": null
+      },
+      "elapsedSeconds": 57.01,
+      "review": "Independent review passed: relevant skills consulted, bounded change, preserved tests, 2/2 passed.",
+      "evidenceSha256": {
+        "-setup.json": "2bfa306ace9aebfa6a3534540962e9cfc5ec25b1c211a941078526fe03f0fa39",
+        ".jsonl": "6bceff4a9916e2fdd5413e2ead7630097785cc13425a989386655600a92ef80f",
+        ".stderr": "aa0a6e878075b2f4554c9e181ff7daadd2e8fc099a9313d34d84a14fca076690"
+      }
+    },
+    {
+      "id": "matched-b1-1-none",
+      "status": "exited",
+      "objectiveChecksPassed": true,
+      "usage": {
+        "inputTokens": 49207,
+        "outputTokens": 1041,
+        "cachedInputTokens": 35968,
+        "costUSD": null
+      },
+      "elapsedSeconds": 30.329,
+      "review": "Objective checks passed; no method arm.",
+      "evidenceSha256": {
+        "-setup.json": "131be54e9b8468155bcf2ab40a7ce7a98357f29708728f3c9c13a7cf3595bfdf",
+        ".jsonl": "ad384bb14637b3612910891205ba0e338af1999eaa78eb56b9d9a4c092c549b0",
+        ".stderr": "c95bb25b3d249e4e71dc19a5d6db0a8a08d7bbbd9e855c936496e699c04fdb25"
+      }
+    },
+    {
+      "id": "smoke-b3",
+      "status": "exited",
+      "objectiveChecksPassed": true,
+      "usage": {
+        "inputTokens": 105298,
+        "outputTokens": 1530,
+        "cachedInputTokens": 77952,
+        "costUSD": null
+      },
+      "elapsedSeconds": 44.517,
+      "review": "Independent review passed: unresolved ADR dependency recognized, no invented contract, explicit handoff, 1/1 passed.",
+      "evidenceSha256": {
+        "-setup.json": "63d899f33747045485bb1bedbf8b781806eeaf8fc2d2c2d32b0ed1f5a7f8b7ed",
+        ".jsonl": "2fc8aadd2ee1a8ad1728454dd24528bdb23e040ca4dde91fc2ca4e02578a6999",
+        ".stderr": "3f0820fbf17e94a4b1e5aebc46bd95a75ff89fc5aa60d82bf392bf66b009ba1b"
+      }
+    },
+    {
+      "id": "smoke-b4",
+      "status": "exited",
+      "objectiveChecksPassed": true,
+      "usage": {
+        "inputTokens": 136447,
+        "outputTokens": 2137,
+        "cachedInputTokens": 106880,
+        "costUSD": null
+      },
+      "elapsedSeconds": 57.67,
+      "review": "Independent review passed: initial failed test evidenced, stale checkpoint corrected against current contract, 1/1 passed. Initial test requested explicitly; supplied checkpoint, not a two-session chain.",
+      "evidenceSha256": {
+        "-setup.json": "ab2ae33e7882d08fae2c04a00ff687cebf6c4cd3a2fdfcb14574cba74559a8ce",
+        ".jsonl": "a102c8e1d0a3f29ffa1060db3c154803df1c45531bb5b670949d89349399a9d7",
+        ".stderr": "09c25279076b0b51db41952e7c4d4c622f531173ef5493f470f07e3cf6f414ae"
+      }
+    }
+  ],
+  "cells": [
+    {
+      "arm": "none",
+      "planned": 3,
+      "executed": 1,
+      "notRun": 2,
+      "objectivePassed": 1,
+      "objectiveFailed": 0
+    },
+    {
+      "arm": "devmethod",
+      "planned": 3,
+      "executed": 1,
+      "notRun": 2,
+      "objectivePassed": 1,
+      "objectiveFailed": 0
+    },
+    {
+      "arm": "bmad",
+      "planned": 3,
+      "executed": 1,
+      "notRun": 2,
+      "objectivePassed": 0,
+      "objectiveFailed": 1
+    }
+  ],
+  "totalTokens": 549327,
+  "costUSD": null,
+  "limits": {
+    "maxRuns": 12,
+    "timeoutSeconds": 120,
+    "observedTokenStop": 500000
+  },
+  "limitation": "Calibration excluded from matched cells. Objective success is not behavioral review or proof of superiority. Unknown cost remains unavailable.",
+  "date": "2026-09-13",
+  "host": "Codex CLI 0.147.0 / macOS",
+  "model": "gpt-5.6-sol",
+  "effort": "low",
+  "sourceRevision": "385c56f55691c2904d96a3360ed0d38ce3ecb535",
+  "stopReason": "Observed threshold crossed within sixth invocation; six remaining invocations not dispatched.",
+  "rawEvidence": "Retained locally, not included in package; hashes permit later verification."
+}

package/examples/README.md

@@ -0,0 +1,36 @@
+# Starter exercises
+
+These are fictional tasks, not recorded agent successes. Keep generated application code in a disposable repository. The public npm candidate predates the new work-sizing reference; use a reviewed source checkout to evaluate that guidance.
+
+## B1: runnable small bug fix
+
+Copy `examples/bugfix/` into a new directory outside the DevMethod checkout. With Node.js 22+, run:
+
+```bash
+node --test acceptance.test.mjs
+```
+
+The two tests intentionally fail on the starting implementation. This is expected and separate from DevMethod's own `npm test`. Optionally initialize a local Git repository to record the baseline, then install the chosen method into that fixture directory. For DevMethod, run from the reviewed DevMethod checkout:
+
+```bash
+node dist/cli.js init --tool codex --dest /path/to/fixture
+node dist/cli.js doctor --dest /path/to/fixture
+```
+
+Use this task in the host; select `project-foundation` with the host's invocation syntax when testing DevMethod:
+
+> Fix parsePageSize in page-size.mjs. Accept positive safe integer numbers and strings containing only decimal digits after trimming. Cap valid values at 100. Return 20 for every other value; do not coerce objects. Preserve the export and acceptance.test.mjs. Make no dependency additions or unrelated changes. Run node --test acceptance.test.mjs, review the diff, and report the observed result. Delivery is local only. Finish when this scope is verified.
+
+Expected artifacts: focused implementation diff, actual test output and concise outcome. No new product spec or architecture decision is needed. Keep the starting fixture unchanged in this repository so subsequent evaluations use the same input.
+
+## Existing React feature prompt
+
+Requires an existing application, approved UI reference and real project commands; it is not a bundled runnable fixture.
+
+> Use project-foundation to add an empty state to [existing screen], following [approved reference]. Reuse the installed components and existing server-state mechanism. Keep request orchestration in the existing feature hook and pure transformations outside the view. Preserve loading/error behavior and keyboard accessibility. Inspect package.json and applicable instructions to choose actual checks; verify the relevant rendered states. Scope excludes restyling other screens, dependency upgrades and deployment. Ask only about unresolved behavior that affects implementation.
+
+## AI integration prompt
+
+Requires an existing application and an approved provider contract. Live provider calls need the project's existing authorization and budget.
+
+> Use project-foundation for [ticket]: add a summary action using the already approved provider behind the existing backend boundary. Validate inputs and output shape, keep credentials server-side, and preserve the specified timeout, retry and quota policy. Treat document content as untrusted data. Do not claim generated summaries are factual without the ticket's evidence criteria. Test success, invalid output and provider failure using the existing test setup; report live-provider validation separately. Scope excludes choosing a new provider, buying services or deployment.

package/examples/bugfix/acceptance.test.mjs

@@ -0,0 +1,17 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { parsePageSize } from './page-size.mjs';
+
+test('accepts positive safe integers and caps them at 100', () => {
+  for (const [input, expected] of [[1, 1], [25, 25], [' 12 ', 12], ['005', 5], [100, 100], [150, 100], ['150', 100]]) {
+    assert.equal(parsePageSize(input), expected, String(input));
+  }
+});
+
+test('invalid inputs return the default 20 without coercing objects', () => {
+  for (const input of [undefined, null, '', ' ', 0, -1, 1.5, NaN, Infinity, true, false,
+    [], [2], {}, '1.5', '-2', '+2', '1e2', '0x10', 'Infinity', Number.MAX_SAFE_INTEGER + 1,
+    { valueOf() { throw new Error('Must not coerce objects'); } }]) {
+    assert.equal(parsePageSize(input), 20);
+  }
+});

package/examples/bugfix/page-size.mjs

@@ -0,0 +1,4 @@
+// Intentionally defective starting point for the B1 workflow exercise.
+export function parsePageSize(input) {
+  return Number(input) || 20;
+}

package/examples/clair-from-zero/AGENT-EVALUATION.md

@@ -0,0 +1,15 @@
+# Relevé de l’essai Clair
+
+Date : 2026-09-13. Dossier initial : kit fraîchement installé, aucune application. Source du produit : brief transmis par l’agent parent, dont la sélection détaillée des écrans est déléguée. Le relevé est une observation de cette exécution, pas une comparaison de méthodes.
+
+Les lectures initiales et décisions ont précédé le code. Exploration/cadrage/design/architecture/plan/readiness ont été groupés en une tranche standard CLAIR-1, puis implémentation, tests et revue locale. Le seul enregistrement courant est `docs/missions/clair.md`. Ce rapport est un instantané ; aucun document par étape. Aucun imagegen, réseau, dépendance ou sous-agent utilisé. Le kit est resté intact ; le profil adopté est dans la mission pour respecter cette contrainte.
+
+Fichiers lus : START_HERE.md, AGENTS.foundation.md, PROJECT_PROFILE.md, ENGINEERING_POLICY.template.md ; SKILL.md de project-foundation, design-to-code, scoped-delivery et decision-architecture ; références work-sizing, operating-commands, mission-context, visual-creation, ux-contract, verification-and-cost ; modèle scoped-delivery/assets/MISSION.md ; kit-manifest.json. CONTRIBUTING.md et AGENTS.md étaient absents. Les autres modules ont été découverts par inventaire, sans être chargés.
+
+Fichiers créés : app/index.html, app/styles.css, app/app.mjs, app/domain.mjs, app/storage.mjs, tests/domain.test.mjs, docs/missions/clair.md et ce rapport. Livré : page française responsive ivoire/encre/rouille, ajout titre/note, validation, toggle, trois filtres, suppression/annulation, localStorage versionné et validé, alerte d’échec persistante/réessai, réinitialisation explicite après erreur de lecture, départ vide et ajout de trois tâches de démonstration marquées fictives.
+
+Exécuté : `node --test tests/*.test.mjs` — 6 tests passés, 0 échec ; `node --check app/app.mjs` — passé. Vérification des hashes SHA-256 des fichiers du manifeste installé — aucune différence. Revue locale du code et des limites ; aucune installation ni ressource distante.
+
+Limites : cet agent n’a pas lancé de navigateur, capturé d’écran, testé l’interaction réelle ou vérifié le rendu mobile. Le parent en est chargé indépendamment. Les vérifications DOM/CSS effectuées sont des inspections du source. Aucune preuve d’intégration, de déploiement ou d’usage production. L’application conserve les priorités jusqu’à suppression ; aucune remise à zéro quotidienne ni synchronisation entre onglets. L’annulation porte sur la dernière suppression et disparaît après rechargement. La démo peut être ajoutée plusieurs fois volontairement.
+
+Lancer : `python3 -m http.server 8766 --bind 127.0.0.1 --directory app`. Prochaine commande méthode : `$project-foundation verify CLAIR-1`.

package/examples/clair-from-zero/MISSION.md

@@ -0,0 +1,41 @@
+# Clair — mission canonique
+
+2026-09-13, livraison standard, propriétaire : agent de réalisation.
+
+## Sources et profil adopté
+Le brief transmis par le parent fait autorité : application française locale, HTML/CSS/JS sans dépendances ni comptes, direction ivoire/encre/rouille et sérif ; choix détaillés délégués. Les fichiers du kit restent intacts, notamment PROJECT_PROFILE.md : ce paragraphe porte le profil adopté conformément à la contrainte de préservation. CONTRIBUTING.md et AGENTS.md sont absents. ENGINEERING_POLICY.template.md est un modèle ; le JavaScript demandé prend priorité sur sa recommandation TypeScript.
+
+Stack : modules JavaScript natifs, CSS, HTML ; Node pour les tests purs ; Python pour le serveur local. Commandes : `node --test tests/*.test.mjs` ; `python3 -m http.server 8766 --bind 127.0.0.1 --directory app`. Aucun déploiement, réseau, installation ou génération d’images autorisé. Données : titres, notes et état d’achèvement stockés sous clair.tasks.v1 dans localStorage, conservés jusqu’à suppression ou effacement du navigateur ; aucune synchronisation ni télémétrie.
+
+## Framing, design et architecture — décisions avant code
+Valeur : choisir et suivre les priorités du jour sans configuration. Direction existante explicite, choix d’écran délégué ; aucune image ou maquette séparée nécessaire. Prototype HTML final choisi comme support. Grand titre éditorial, date, compteur, liste principale et formulaire latéral ; mobile en une colonne avec formulaire avant la liste. Palette #f7f3eb, #292923, #97472f ; Georgia système et sans-sérif système. États : vide, filtres vides, tâches actives/terminées, validation, suppression/annulation, stockage indisponible/corrompu.
+
+Choix structurel dans le cadre délégué : module pur pour validation/transitions/schéma, adaptateur localStorage, contrôleur DOM. Une page monolithique serait plus courte mais rendrait les invariants difficiles à tester isolément. Aucun framework utile au périmètre. Les titres/notes ne deviennent jamais du HTML. Échec d’écriture : garder la session en mémoire et afficher une alerte persistante avec réessai ; erreur de lecture : ne pas écraser les données sans action explicite de réinitialisation. Suppression réversible de la dernière tâche, sans expiration temporelle. Pas de réinitialisation automatique à minuit.
+
+## Plan et readiness (avant implémentation)
+Une tranche CLAIR-1 couvre AC1 ajout titre/note et validation ; AC2 toggle/filtres ; AC3 suppression/annulation ; AC4 persistance/schema/erreurs ; AC5 vide + démo explicitement fictive ; AC6 responsive/clavier/focus. Contrats prêts, dépendances résolues. Tests prévus sur invariants et stockage ; vérification navigateur déléguée au parent et non revendiquée par cet agent. Limites de titre 160 caractères et note 500, données versionnées et validées à la lecture. Fin de périmètre après réalisation locale et tests ; pas de fonctionnalités hors brief.
+
+## Evidence et état
+État courant après vérification parent : CLAIR-1 réalisé et vérifié dans Chrome desktop/mobile. Les étapes explorations/cadrage/design/architecture/plan/readiness ont été groupées, pas de document par étape.
+
+## Résultat local et evidence — 2026-09-13
+CLAIR-1 réalisé dans `app/`. État lors du retour de l’agent : implémentation locale terminée, acceptation navigateur alors en attente. Aucun commit, PR ou déploiement.
+
+| Critère | Preuve exécutée | Résultat |
+|---|---|---|
+| AC1 | `node --test tests/*.test.mjs`, cas validation | passé : blanc, trim, bornes titre/note |
+| AC2 | même commande, toggle/filtres | passé : immutabilité et ordre |
+| AC3 | même commande, suppression/annulation | passé : position, ajout intermédiaire, absence et doublon |
+| AC4 | même commande, schéma/adapter | passé : round-trip Unicode, JSON invalide, version, types, IDs dupliqués, exceptions lecture/écriture |
+| AC5 | revue du contrôleur et HTML | démarrage vide sans données ; bouton de démo explicitement fictif, notes marquées ; navigateur non exécuté |
+| AC6 | revue CSS/DOM | labels, focus visible, annonces, règles 700/1000 px et réduction de mouvement présentes ; comportement/rendu navigateur non vérifiés |
+
+Commande `node --check app/app.mjs` passée. Six tests, zéro échec. Revue locale de ses propres fichiers : contenu utilisateur inséré via textContent, stockage traité au bord, aucune ressource distante, aucun secret, actions couvertes dans le contrôleur. Cette inspection ne démontre pas l'accessibilité complète. Vérification SHA-256 des fichiers installés contre kit-manifest.json : aucun changement. Aucun test navigateur réalisé par cet agent, aucune comparaison pixel ou audit automatique revendiqué.
+
+Prochaine action exacte : parent, exécuter la vérification desktop/mobile et des parcours de CLAIR-1 sur le serveur local. Commande méthode recommandée : `$project-foundation verify CLAIR-1`.
+
+## Vérification indépendante du parent
+
+Interactions Chrome vérifiées : vide, validation, ajout/note, toggle/filtres, rechargement, suppression/annulation, démo, saisie clavier, absence de débordement à 390px, échec de stockage avec conservation en mémoire et alerte. Captures desktop/mobile inspectées. Les animations sont désactivées pour les captures afin de ne pas photographier une barre de progression en transition. Aucun audit complet d’accessibilité.
+
+Constat méthode : l’agent avait conservé une ancienne ligne « implémentation en cours » avant son résultat final. Le parent l’a réconciliée ici ; ce besoin de correction empêche de présenter la tenue du statut comme entièrement autonome. Le rapport agent est un instantané historique. Prochaine action : aucune implémentation restante dans ce périmètre ; intégration et vidéo suivies dans le dépôt DevMethod.

package/examples/clair-from-zero/README.md

@@ -0,0 +1,24 @@
+# Clair — an actual from-zero DevMethod pilot
+
+Clair is a fictional French personal-priorities app created by a separate Codex subagent in a new directory containing only the installed DevMethod kit. The parent provided a bounded brief and delegated the detailed editorial visual choices. No application code or previous implementation was supplied. This is a same-host subagent test, not a fresh standalone Codex/Claude session or a comparative benchmark.
+
+## Run
+
+From this directory:
+
+```sh
+python3 -m http.server 8766 --bind 127.0.0.1 --directory app
+node --test tests/*.test.mjs
+```
+
+Open http://127.0.0.1:8766. Stop the server with Ctrl-C. No npm dependencies, backend, external fonts, account or provider key. Browser storage uses `clair.tasks.v1`. The application starts empty; its demo button explicitly adds fictional tasks. Delete/undo covers the last deletion and does not survive reload. There is no cross-tab synchronization or daily reset.
+
+## What was observed
+
+The implementing agent grouped framing, design, architecture, planning and readiness in one mission. It created five app files, a test file, one mission and the requested evaluation snapshot; all installed kit files retained their hashes. Six logic/storage tests passed. The parent then exercised the actual Chrome UI: blank validation, add/note, completion/filters, persistence, delete/undo, demo, keyboard submission, 390px overflow and write-failure recovery.
+
+[Agent report](AGENT-EVALUATION.md) is a historical observation. [Mission](MISSION.md) includes parent checks and disclosed limitations. A stale status sentence left by the implementing agent was reconciled by the parent; this was not perfect autonomous bookkeeping. The design was delegated, so this test does not repeat the user-choice/image steps of the separate [Lisière pilot](../visual-pilot/README.md).
+
+Browser check from the DevMethod repository root: `node examples/clair-from-zero/browser-check.cjs`, with Playwright and Chrome available. Set PLAYWRIGHT_MODULE to an installed Playwright module path when needed. It writes captures under docs/media/from-zero/captures and uses a temporary browser profile.
+
+[French video and transcript](../../docs/media/from-zero/README.md) show this app's actual interactions and separately identify the Lisière visual pilot. Neither demonstration establishes general code quality, production readiness, lower costs or superiority over BMAD.

package/examples/clair-from-zero/app/app.mjs

@@ -0,0 +1,69 @@
+import {createTask,toggleTask,removeTask,restoreTask,filterTasks} from './domain.mjs';
+import {readTasks,writeTasks} from './storage.mjs';
+const $ = selector => document.querySelector(selector);
+let tasks = [], filter = 'all', removed = null, readBlocked = false;
+const announce = message => { $('#announcement').textContent = message; };
+function showStorageError(message, blocked = false) {
+  $('#storage-alert').hidden = false; $('#storage-message').textContent = message;
+  $('#retry-storage').hidden = blocked; $('#reset-storage').hidden = !blocked;
+}
+try { tasks = readTasks(window.localStorage); }
+catch { readBlocked = true; showStorageError('Les données enregistrées ne peuvent pas être lues. Vos changements restent uniquement en mémoire. Pour protéger les données existantes, la sauvegarde est suspendue. Vous pouvez les effacer explicitement pour repartir avec cette liste.', true); }
+function save() {
+  if (readBlocked) return;
+  try { writeTasks(window.localStorage, tasks); $('#storage-alert').hidden = true; }
+  catch { showStorageError('La sauvegarde a échoué. Vos changements restent uniquement en mémoire et peuvent être perdus à la fermeture ou au rechargement. Libérez de l’espace ou autorisez le stockage, puis réessayez.'); }
+}
+function commit(message) { save(); render(); announce(message); }
+function setFilter(value) { filter = value; render(); }
+function render() {
+  const done = tasks.filter(task => task.done).length;
+  $('#total-count').textContent = String(tasks.length).padStart(2,'0');
+  $('#all-count').textContent = tasks.length; $('#active-count').textContent = tasks.length-done; $('#done-count').textContent = done;
+  $('#progress-label').textContent = tasks.length ? `${done} sur ${tasks.length} terminée${tasks.length > 1 ? 's' : ''}` : 'Un nouveau départ';
+  $('#progress-bar').style.width = `${tasks.length ? done/tasks.length*100 : 0}%`;
+  document.querySelectorAll('[data-filter]').forEach(button => button.setAttribute('aria-pressed', String(button.dataset.filter === filter)));
+  const visible = filterTasks(tasks, filter), list = $('#task-list'); list.replaceChildren();
+  for (const task of visible) {
+    const row = document.createElement('li'); row.className = `task${task.done?' done':''}`; row.dataset.id = task.id;
+    const check = document.createElement('button'); check.type = 'button'; check.className = 'task-check'; check.setAttribute('role','checkbox'); check.setAttribute('aria-checked', String(task.done)); check.setAttribute('aria-label', `${task.done?'Marquer à faire':'Terminer'} : ${task.title}`); check.textContent = task.done ? '✓' : '';
+    check.addEventListener('click', () => {
+      const position = visible.findIndex(item => item.id === task.id);
+      tasks = toggleTask(tasks, task.id); commit(task.done ? 'Priorité marquée à faire.' : 'Priorité terminée.');
+      const newRows = [...list.children], same = newRows.find(item => item.dataset.id === task.id);
+      (same?.querySelector('.task-check') || newRows[Math.min(position,newRows.length-1)]?.querySelector('.task-check') || $('#empty-add')).focus();
+    });
+    const content = document.createElement('div'), title = document.createElement('h3'); title.textContent = task.title; content.append(title);
+    if (task.note) { const note = document.createElement('p'); note.textContent = task.note; content.append(note); }
+    if (task.done) { const state = document.createElement('span'); state.className = 'task-state'; state.textContent = 'TERMINÉE'; content.append(state); }
+    const del = document.createElement('button'); del.type = 'button'; del.className = 'task-delete'; del.setAttribute('aria-label', `Supprimer : ${task.title}`);
+    del.innerHTML = '<svg viewBox="0 0 20 22" aria-hidden="true"><path d="M3 6h14M7 6V3h6v3M5 6l1 14h8l1-14M8 9v8M12 9v8"/></svg>';
+    del.addEventListener('click', () => { const result = removeTask(tasks, task.id); tasks = result.tasks; removed = result.removed; commit('Priorité supprimée. Vous pouvez annuler.'); $('#undo-button').focus(); });
+    row.append(check,content,del); list.append(row);
+  }
+  $('#empty-state').hidden = visible.length > 0;
+  if (!tasks.length) { $('#empty-title').textContent = 'Tout commence par une chose.'; $('#empty-copy').textContent = 'Qu’aimeriez-vous faire avancer aujourd’hui ? Ajoutez votre première priorité, même petite.'; $('#empty-add').textContent = 'Écrire ma première priorité ↗'; }
+  else if (filter === 'done') { $('#empty-title').textContent = 'Chaque chose en son temps.'; $('#empty-copy').textContent = 'Vos priorités terminées apparaîtront ici. Un petit pas suffit pour commencer.'; $('#empty-add').textContent = 'Voir les priorités à faire ↗'; }
+  else { $('#empty-title').textContent = 'De la place pour souffler.'; $('#empty-copy').textContent = 'Toutes vos priorités sont terminées. Savourez ce que vous avez fait aujourd’hui.'; $('#empty-add').textContent = 'Ajouter une nouvelle priorité ↗'; }
+  $('#undo-bar').hidden = !removed;
+}
+$('#task-form').addEventListener('submit', event => {
+  event.preventDefault();
+  try {
+    const task = createTask($('#task-title').value, $('#task-note').value, crypto.randomUUID());
+    tasks = [...tasks,task]; filter = 'all'; $('#task-form').reset(); $('#form-error').hidden = true; $('#task-title').removeAttribute('aria-invalid'); commit('Priorité ajoutée.'); $('#task-title').focus();
+  } catch (error) { $('#form-error').textContent = error.message; $('#form-error').hidden = false; $('#task-title').setAttribute('aria-invalid','true'); $('#task-title').focus(); }
+});
+$('#task-title').addEventListener('input', () => { if ($('#task-title').value.trim()) { $('#form-error').hidden = true; $('#task-title').removeAttribute('aria-invalid'); } });
+document.querySelectorAll('[data-filter]').forEach(button => button.addEventListener('click', () => { setFilter(button.dataset.filter); announce(`${filterTasks(tasks,filter).length} priorité(s) affichée(s).`); }));
+$('#empty-add').addEventListener('click', () => { if (tasks.length && filter === 'done') { setFilter('active'); $('[data-filter="active"]').focus(); } else { $('#task-title').focus(); $('#task-title').scrollIntoView({block:'center',behavior:'auto'}); } });
+$('#undo-button').addEventListener('click', () => { const id = removed?.task.id; tasks = restoreTask(tasks,removed); removed = null; filter = 'all'; commit('Suppression annulée.'); [...$('#task-list').children].find(row => row.dataset.id === id)?.querySelector('.task-check').focus(); });
+$('#dismiss-undo').addEventListener('click', () => { removed = null; render(); $('#priorities').focus(); });
+$('#demo-button').addEventListener('click', () => {
+  const examples = [['Lire quelques pages','Démo fictive · Un chapitre, un thé et le téléphone de côté.'],['Faire une promenade','Démo fictive · Vingt minutes sans itinéraire.'],['Écrire à une personne chère','Démo fictive · Juste quelques mots pour prendre des nouvelles.']];
+  tasks = [...tasks,...examples.map(([title,note]) => createTask(title,note,crypto.randomUUID()))]; filter = 'all'; commit('Trois priorités fictives ajoutées à la liste.');
+});
+$('#retry-storage').addEventListener('click', () => { save(); if ($('#storage-alert').hidden) { announce('Liste sauvegardée dans ce navigateur.'); $('#task-title').focus(); } });
+$('#reset-storage').addEventListener('click', () => { readBlocked = false; save(); if ($('#storage-alert').hidden) { announce('Les anciennes données ont été remplacées par la liste actuelle.'); $('#task-title').focus(); } });
+$('#today').textContent = new Intl.DateTimeFormat('fr-FR',{weekday:'long',day:'numeric',month:'long'}).format(new Date()).toLocaleUpperCase('fr-FR');
+render();

package/examples/clair-from-zero/app/domain.mjs

@@ -0,0 +1,30 @@
+export const TITLE_LIMIT = 160;
+export const NOTE_LIMIT = 500;
+export function createTask(title, note, id) {
+  if (typeof title !== 'string' || !title.trim()) throw new Error('Donnez un titre à votre priorité.');
+  if (title.trim().length > TITLE_LIMIT) throw new Error('Le titre est limité à 160 caractères.');
+  if (typeof note !== 'string' || note.trim().length > NOTE_LIMIT) throw new Error('La note est limitée à 500 caractères.');
+  return { id, title: title.trim(), note: note.trim(), done: false };
+}
+export function toggleTask(tasks, id) { return tasks.map(task => task.id === id ? {...task, done: !task.done} : task); }
+export function removeTask(tasks, id) {
+  const index = tasks.findIndex(task => task.id === id);
+  return { tasks: tasks.filter(task => task.id !== id), removed: index < 0 ? null : { task: tasks[index], index } };
+}
+export function restoreTask(tasks, removed) {
+  if (!removed || tasks.some(task => task.id === removed.task.id)) return tasks;
+  const result = [...tasks]; result.splice(Math.min(removed.index, result.length), 0, removed.task); return result;
+}
+export function filterTasks(tasks, filter) { return tasks.filter(task => filter === 'done' ? task.done : filter === 'active' ? !task.done : true); }
+export function decodeTasks(raw) {
+  if (raw === null) return [];
+  const data = JSON.parse(raw);
+  if (!data || data.version !== 1 || !Array.isArray(data.tasks)) throw new Error('Format de données inconnu.');
+  const ids = new Set();
+  for (const task of data.tasks) {
+    if (!task || typeof task.id !== 'string' || !task.id || ids.has(task.id) || typeof task.title !== 'string' || !task.title.trim() || task.title.length > TITLE_LIMIT || typeof task.note !== 'string' || task.note.length > NOTE_LIMIT || typeof task.done !== 'boolean') throw new Error('Données enregistrées illisibles.');
+    ids.add(task.id);
+  }
+  return data.tasks.map(({id, title, note, done}) => ({id, title, note, done}));
+}
+export function encodeTasks(tasks) { return JSON.stringify({version: 1, tasks}); }

package/examples/clair-from-zero/app/index.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="fr">
+<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="theme-color" content="#f7f3eb"><title>Clair — Place à l’essentiel</title><link rel="stylesheet" href="styles.css"><script type="module" src="app.mjs"></script></head>
+<body>
+<a class="skip" href="#priorities">Aller aux priorités</a>
+<div class="page">
+<header class="masthead"><a class="brand" href="./" aria-label="Clair, accueil">clair<span class="brand-dot">✳</span></a><span class="masthead-note">UN PEU MOINS. UN PEU MIEUX.</span><span class="edition">VOTRE ESPACE PERSONNEL</span></header>
+<main>
+<section class="hero" aria-labelledby="hero-title"><div><p class="eyebrow" id="today">LE FIL DU JOUR</p><h1 id="hero-title">Faire place<br>à <em>l’essentiel.</em></h1><p class="intro">Une journée, quelques priorités.<br>Gardez de la place pour ce qui compte vraiment.</p></div><div class="hero-aside" aria-hidden="true"><div class="sun"><i></i><i></i><i></i><i></i></div><p>Moins de bruit.<br>Plus de présence.</p><span>À VOTRE RYTHME</span></div></section>
+<div id="storage-alert" class="storage-alert" role="alert" hidden><p id="storage-message"></p><button type="button" id="retry-storage">Réessayer la sauvegarde</button><button type="button" id="reset-storage" hidden>Effacer les données illisibles</button></div>
+<div class="workspace">
+<section class="priorities" id="priorities" aria-labelledby="list-heading" tabindex="-1"><div class="section-heading"><h2 id="list-heading">Vos priorités</h2><span class="count" id="total-count">00</span></div><div class="list-toolbar"><div class="filters" role="group" aria-label="Filtrer les priorités"><button type="button" data-filter="all" aria-pressed="true">Toutes <span id="all-count">0</span></button><button type="button" data-filter="active" aria-pressed="false">À faire <span id="active-count">0</span></button><button type="button" data-filter="done" aria-pressed="false">Terminées <span id="done-count">0</span></button></div><span id="progress-label" class="progress-label">Un nouveau départ</span></div><div class="progress-track" aria-hidden="true"><div id="progress-bar"></div></div><ul id="task-list" aria-label="Liste des priorités"></ul><div id="empty-state" class="empty-state"><div class="empty-mark" aria-hidden="true">✳</div><h3 id="empty-title">Tout commence par une chose.</h3><p id="empty-copy">Qu’aimeriez-vous faire avancer aujourd’hui ?<br>Ajoutez votre première priorité, même petite.</p><button type="button" id="empty-add" class="text-button">Écrire ma première priorité <span aria-hidden="true">↗</span></button></div><div class="list-foot"><span id="list-note">Une petite liste. Une intention claire.</span><button type="button" id="demo-button">Charger une démo fictive <span aria-hidden="true">↗</span></button></div></section>
+<aside class="composer" aria-labelledby="form-heading"><p class="eyebrow">UNE CHOSE À LA FOIS</p><h2 id="form-heading">Qu’est-ce qui<br>compte <em>aujourd’hui ?</em></h2><form id="task-form" novalidate><label for="task-title">Votre priorité <span aria-hidden="true">*</span></label><input id="task-title" name="title" type="text" maxlength="160" placeholder="Par exemple, prendre le temps de lire" required aria-describedby="form-error" autocomplete="off"><label for="task-note">Une note <span class="optional">— facultatif</span></label><textarea id="task-note" name="note" maxlength="500" rows="3" placeholder="Un détail, une idée, un premier pas…"></textarea><p id="form-error" class="form-error" role="alert" hidden></p><button class="add-button" type="submit">Ajouter une priorité <span aria-hidden="true">+</span></button></form><p class="form-tip">Pas besoin de tout prévoir.<br>Commencez par ce qui vous tient à cœur.</p></aside>
+</div>
+</main>
+<footer><span class="footer-brand">clair</span><p>Vos priorités restent dans ce navigateur.<br>Aucun compte. Aucune synchronisation.</p><span class="footer-note">CHAQUE PETIT PAS COMPTE.</span></footer>
+</div>
+<div id="undo-bar" class="undo-bar" role="status" hidden><span>Priorité supprimée.</span><button type="button" id="undo-button">Annuler</button><button type="button" id="dismiss-undo" aria-label="Fermer la notification de suppression">×</button></div><div class="sr-only" id="announcement" role="status" aria-live="polite"></div>
+<noscript><p class="noscript">Activez JavaScript pour utiliser Clair. Aucune donnée n’est envoyée à un serveur.</p></noscript>
+</body></html>

package/examples/clair-from-zero/app/storage.mjs

@@ -0,0 +1,4 @@
+import { decodeTasks, encodeTasks } from './domain.mjs';
+export const STORAGE_KEY = 'clair.tasks.v1';
+export function readTasks(storage) { return decodeTasks(storage.getItem(STORAGE_KEY)); }
+export function writeTasks(storage, tasks) { storage.setItem(STORAGE_KEY, encodeTasks(tasks)); }