devmethod-ai 0.1.0-rc.2 → 0.2.0

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);
+}

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

@@ -0,0 +1,9 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { filterBooks } from './filter.mjs';
+const books = [{ title: 'A', status: 'reading' }, { title: 'B', status: 'planned' }];
+test('all retains order and every book', () => assert.deepEqual(filterBooks(books, 'all'), books));
+test('status filters without mutating source', () => {
+  assert.deepEqual(filterBooks(books, 'reading'), [books[0]]);
+  assert.equal(books.length, 2);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devmethod-ai",
-  "version": "0.1.0-rc.2",
+  "version": "0.2.0",
   "description": "From idea to delivery with your AI coding agents",
   "license": "MIT",
   "type": "module",
@@ -13,8 +13,15 @@
   "files": [
     "dist/",
     ".agents/skills/",
+    "docs/",
+    "examples/",
+    "evaluation/",
+    "scripts/",
     "LICENSE",
-    "COMPATIBILITY.md"
+    "COMPATIBILITY.md",
+    "CONTRIBUTING.md",
+    "VALIDATION.md",
+    "START_HERE.md"
   ],
   "repository": {
     "type": "git",
@@ -22,7 +29,12 @@
   },
   "scripts": {
     "build": "tsc",
-    "test": "npm run build && node --test tests/*.test.mjs"
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "test:fixtures": "node --test tests/evaluation.test.mjs",
+    "check:docs": "node scripts/check-docs.mjs",
+    "test:cli": "node --test tests/install.test.mjs tests/doctor.test.mjs tests/update.test.mjs tests/checkpoint.test.mjs tests/resume-cli.test.mjs tests/mission.test.mjs tests/planner.test.mjs",
+    "test:protocols": "node --test tests/comparison.test.mjs",
+    "test:greenfield": "node --test examples/pocket-tasks/tests/*.test.mjs evaluation/greenfield/*.test.mjs examples/clair-from-zero/tests/*.test.mjs"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/scripts/check-codex-git.mjs

@@ -0,0 +1,20 @@
+// Native sandbox preflight, no model invocation. Run explicitly on macOS.
+import fs from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { startCodexRpc } from './hosts/codex-rpc.mjs';
+export async function checkCodexGit() {
+  if(process.platform!=='darwin')throw new Error('macOS preflight only');
+  const cwd=fs.mkdtempSync('/private/tmp/devmethod-git-sandbox-');
+  execFileSync('git',['init',cwd]);fs.writeFileSync(cwd+'/sentinel.txt','fictional\n');
+  const rpc=startCodexRpc({cwd,timeoutMs:20000});const results=[];
+  try {
+    await rpc.call('initialize',{clientInfo:{name:'devmethod_probe',version:'0.1.0'},capabilities:{experimentalApi:true}});rpc.notify({method:'initialized'});
+    for(const includeGit of [false,true]) {
+      const result=await rpc.call('command/exec',{command:['git','add','sentinel.txt'],cwd,timeoutMs:5000,sandboxPolicy:{type:'workspaceWrite',writableRoots:includeGit?[cwd,cwd+'/.git']:[cwd],networkAccess:false,excludeTmpdirEnvVar:true,excludeSlashTmp:true}});
+      results.push({includeGit,exitCode:result.exitCode});
+    }
+    if(results[0].exitCode===0||results[1].exitCode!==0)throw new Error('Unexpected Git sandbox result');
+    return {gitMetadataWritable:true,results};
+  }finally{rpc.close();fs.rmSync(cwd,{recursive:true,force:true});}
+}
+if(process.argv[1]?.endsWith('/check-codex-git.mjs')) console.log(JSON.stringify(await checkCodexGit()));

package/scripts/check-docs.mjs

@@ -0,0 +1,14 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const skip = new Set(['.git', 'node_modules', '.next', 'dist', 'evaluation-private']);
+function files(root) { return fs.readdirSync(root, { withFileTypes: true }).flatMap(e => skip.has(e.name) || e.isSymbolicLink() ? [] : e.isDirectory() ? files(path.join(root, e.name)) : e.name.endsWith('.md') ? [path.join(root, e.name)] : []); }
+const failures = [];
+for (const file of files('.')) {
+  for (const [, target] of fs.readFileSync(file, 'utf8').matchAll(/\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g)) {
+    if (/^[a-z]+:|^#|^<|\$|\{/.test(target)) continue;
+    const relative = decodeURIComponent(target.split('#')[0]);
+    if (relative && !fs.existsSync(path.resolve(path.dirname(file), relative))) failures.push(`${file}: ${target}`);
+  }
+}
+if (failures.length) { console.error(failures.join('\n')); process.exitCode = 1; }
+else console.log('Local Markdown file links resolve (external URLs and anchors are not checked).');

package/scripts/check-native-sandbox.mjs

@@ -0,0 +1,11 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import assert from 'node:assert/strict';
+import { verifyFixture } from './hosts/checks.mjs';
+const root=fs.mkdtempSync(path.join(fs.realpathSync(os.tmpdir()),'devmethod-sandbox-probe-'));
+const worker=path.join(root,'worker');fs.mkdirSync(worker);const sentinel=path.join(root,'sentinel');fs.writeFileSync(sentinel,'fictional sentinel');
+try {
+  const code=`const fs=require('node:fs'),net=require('node:net'),assert=require('node:assert/strict');assert.throws(()=>fs.readFileSync(${JSON.stringify(sentinel)}));assert.throws(()=>fs.writeFileSync('forbidden.txt','x'));const socket=net.connect({host:'127.0.0.1',port:9});socket.on('error',e=>{assert.equal(e.code,'EPERM');console.log('read/write/network denied');});`;
+  const result=verifyFixture(worker,['-e',code]); assert.equal(result.status,0,result.stdout+result.stderr);console.log(result.stdout.trim());
+}finally{fs.rmSync(root,{recursive:true,force:true});}

package/scripts/comparison-readiness.mjs

@@ -0,0 +1,26 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** Admission requirements for an unattended BMAD/DevMethod comparison.
+ * Evidence is operator supplied; this check does not certify a host.
+ */
+export function comparisonReadiness(evidence) {
+  const required = [
+    'bmadInitializationPassed', 'taskLocalTemporaryDirectory',
+    'methodArtifactsAllowed', 'gitMetadataWritable',
+    'synchronousSubagentsAvailable', 'descendantUsageMeasured',
+    'descendantCancellationVerified', 'equalHostPermissions',
+    'frozenMethodRevisions', 'independentAcceptanceChecks',
+  ];
+  const missing = required.filter(key => evidence[key] !== true);
+  return { ready: missing.length === 0, missing,
+    limitation: 'Requires reviewed native evidence. A true label alone proves no capability.' };
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const file = process.argv[2];
+  if (!file) throw new Error('Usage: node scripts/comparison-readiness.mjs EVIDENCE_JSON');
+  const result = comparisonReadiness(JSON.parse(fs.readFileSync(file, 'utf8')));
+  console.log(JSON.stringify(result, null, 2));
+  if (!result.ready) process.exitCode = 2;
+}

package/scripts/comparison.mjs

@@ -0,0 +1,42 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const arms = ['none', 'devmethod', 'bmad'];
+const nonempty = value => typeof value === 'string' && value.trim().length > 0;
+const finite = value => typeof value === 'number' && Number.isFinite(value) && value >= 0;
+/** Validate a complete matched batch, including blocked/failed runs. Never dispatch models. */
+export function summarize(batch) {
+  if (!batch || batch.format !== 1 || !Array.isArray(batch.runs) || !batch.runs.length) throw new Error('Expected format 1 nonempty batch');
+  const { budget } = batch;
+  if (!budget || !Number.isSafeInteger(budget.runs) || budget.runs < 1 || !Number.isSafeInteger(budget.tokens) || budget.tokens < 1 || !finite(budget.costUSD) || !nonempty(budget.authorization)) throw new Error('Explicit run/token/cost budget and authorization required');
+  if (batch.runs.length > budget.runs) throw new Error('Run budget exceeded');
+  const groups = new Map();
+  const matchedKeys = ['fixtureDigest', 'promptDigest', 'hostVersion', 'model', 'toolsDigest', 'permissionsDigest', 'perRunTokens', 'perRunCostUSD', 'timeoutSeconds'];
+  const digests = ['fixtureDigest', 'promptDigest', 'toolsDigest', 'permissionsDigest'];
+  for (const run of batch.runs) {
+    if (!run || !nonempty(run.caseId) || !Number.isSafeInteger(run.repetition) || run.repetition < 1 || !arms.includes(run.arm) || !['passed', 'failed', 'blocked', 'timeout'].includes(run.status)) throw new Error('Invalid run identity or status');
+    if (!matchedKeys.every(key => ['perRunTokens', 'perRunCostUSD', 'timeoutSeconds'].includes(key) ? finite(run[key]) && (key === 'perRunCostUSD' || run[key] > 0) : nonempty(run[key])) || !digests.every(key => /^[a-f0-9]{64}$/.test(run[key]))) throw new Error('Missing pinned matched conditions');
+    if (!nonempty(run.methodRevision) || !nonempty(run.wrapper) || (run.arm === 'none' && run.methodRevision !== 'none')) throw new Error('Pin method revision and invocation wrapper');
+    if (!nonempty(run.evidence) || !nonempty(run.review)) throw new Error('Evidence reference and review or blocked reason required');
+    for (const metric of ['tokens', 'costUSD', 'elapsedSeconds']) if (run[metric] !== null && !finite(run[metric])) throw new Error('Usage must be measured nonnegative values or null (unavailable)');
+    if ((run.tokens !== null && run.tokens > run.perRunTokens) || (run.costUSD !== null && run.costUSD > run.perRunCostUSD)) throw new Error('Per-run budget exceeded');
+    const key = `${run.caseId}:${run.repetition}`;
+    const group = groups.get(key) ?? [];
+    if (group.some(other => other.arm === run.arm)) throw new Error('Duplicate arm');
+    if (group.length && matchedKeys.some(key => run[key] !== group[0][key])) throw new Error('Unmatched conditions');
+    group.push(run); groups.set(key, group);
+  }
+  for (const group of groups.values()) if (group.length !== 3) throw new Error('Each case/repetition requires all three arms, including blocked records');
+  for (const metric of ['tokens', 'costUSD']) if (batch.runs.reduce((sum, run) => sum + (run[metric] ?? 0), 0) > budget[metric]) throw new Error('Total budget exceeded');
+  const cells = [];
+  for (const caseId of new Set(batch.runs.map(run => run.caseId))) for (const arm of arms) {
+    const runs = batch.runs.filter(run => run.caseId === caseId && run.arm === arm);
+    cells.push({ caseId, arm, denominator: runs.length, ...Object.fromEntries(['passed', 'failed', 'blocked', 'timeout'].map(status => [status, runs.filter(run => run.status === status).length])) });
+  }
+  return { format: 1, cells, usageComplete: batch.runs.every(run => run.tokens !== null && run.costUSD !== null),
+    limitation: 'Validates record consistency only. Evidence authenticity and behavioral claims require independent inspection; no aggregate superiority score.' };
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try { if (process.argv.length !== 3) throw new Error('Usage: node scripts/comparison.mjs BATCH_JSON'); console.log(JSON.stringify(summarize(JSON.parse(fs.readFileSync(process.argv[2]))), null, 2)); }
+  catch (error) { console.error(error.message); process.exitCode = 2; }
+}

package/scripts/evaluation.mjs

@@ -0,0 +1,64 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { checkPath } from '../dist/filesystem.js';
+
+const root = fileURLToPath(new URL('../', import.meta.url));
+export const fixtures = JSON.parse(fs.readFileSync(path.join(root, 'evaluation/fixtures.json'))).cases;
+const hash = data => createHash('sha256').update(data).digest('hex');
+export function snapshot(directory) {
+  checkPath(path.resolve(directory));
+  const files = {};
+  function walk(dir, prefix = '') {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true }).sort((a,b) => a.name.localeCompare(b.name))) {
+      if (entry.name === '.git') continue;
+      const relative = prefix + entry.name;
+      if (entry.isSymbolicLink()) throw new Error(`Symbolic evidence path: ${relative}`);
+      if (entry.isDirectory()) walk(path.join(dir, entry.name), relative + '/');
+      else if (entry.isFile()) files[relative] = hash(fs.readFileSync(path.join(dir, entry.name)));
+      else throw new Error(`Non-regular evidence path: ${relative}`);
+    }
+  }
+  walk(directory);
+  return files;
+}
+export function prepare(caseId, destination) {
+  const fixture = fixtures.find(item => item.id === caseId);
+  if (!fixture) throw new Error('Unknown case');
+  destination = path.resolve(destination);
+  checkPath(destination);
+  if (fs.existsSync(destination)) throw new Error('Use a fresh destination');
+  const source = path.join(root, fixture.directory);
+  if (JSON.stringify(Object.entries(snapshot(source)).sort()) !== JSON.stringify(Object.entries(fixture.files).sort())) throw new Error('Fixture differs from pinned manifest');
+  fs.cpSync(source, destination, { recursive: true, errorOnExist: true, force: false });
+  return { format: 1, caseId, destination, baseline: snapshot(destination), prompt: fixture.prompt };
+}
+/** Objective local checks only. This function never invokes or certifies a model. */
+export function collect(caseId, destination, baseline, verifier) {
+  const fixture = fixtures.find(item => item.id === caseId);
+  if (!fixture) throw new Error('Unknown case');
+  const current = snapshot(destination);
+  for (const [name, digest] of Object.entries(fixture.files)) {
+    if (baseline[name] !== digest) throw new Error('Baseline does not contain the pinned fixture');
+  }
+  const changed = [...new Set([...Object.keys(baseline), ...Object.keys(current)])].filter(name => baseline[name] !== current[name]);
+  const unauthorizedChanges = changed.filter(name => !fixture.allowedChanges.includes(name));
+  const testsIntact = current['acceptance.test.mjs'] === fixture.files['acceptance.test.mjs'];
+  // Do not run replaced tests. A native evaluation must separately review model claims.
+  const environment = { ...process.env };
+  delete environment.NODE_TEST_CONTEXT;
+  const check = testsIntact ? verifier ? verifier(destination, fixture.check.slice(1)) : spawnSync(process.execPath, fixture.check.slice(1), { cwd: destination, env: environment, encoding: 'utf8', timeout: 30000, maxBuffer: 1024 * 1024 }) : undefined;
+  return { format: 1, caseId, current, changed, unauthorizedChanges, testsIntact,
+    check: check ? { exit: check.status, signal: check.signal, stdout: check.stdout, stderr: check.stderr, error: check.error?.message } : { skipped: 'Acceptance tests changed' },
+    behavioralReview: 'pending', nativeHostEvidence: 'not established by this collector' };
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    const [command, caseId, destination, baselineFile] = process.argv.slice(2);
+    if (!caseId || !destination || !['prepare', 'collect'].includes(command) || (command === 'collect' && !baselineFile)) throw new Error('Usage: node scripts/evaluation.mjs prepare CASE FRESH_DIR | collect CASE DIR BASELINE_JSON');
+    const result = command === 'prepare' ? prepare(caseId, destination) : collect(caseId, destination, JSON.parse(fs.readFileSync(baselineFile)).baseline);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) { console.error(error.message); process.exitCode = 2; }
+}

package/scripts/fullstack-mission.mjs

@@ -0,0 +1,30 @@
+// Deterministic fixture walkthrough, not a native agent evaluation.
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+import { captureContext } from '../dist/mission.js';
+import { inspectCheckpoint } from '../dist/checkpoint.js';
+import { digest } from '../dist/records.js';
+const root = fileURLToPath(new URL('../examples/fullstack/', import.meta.url));
+const mission = JSON.parse(fs.readFileSync(path.join(root, 'mission.json'), 'utf8'));
+const before = captureContext(root, mission);
+const result = spawnSync(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['test'], {
+  cwd: root, encoding: 'utf8', timeout: 120000, maxBuffer: 1024 * 1024,
+  env: { ...process.env, NEXT_TELEMETRY_DISABLED: '1' }
+});
+const log = `${result.stdout ?? ''}\n${result.stderr ?? ''}\nExit: ${result.status}; error: ${result.error?.message ?? 'none'}\n`;
+fs.mkdirSync(path.join(root, 'evidence'), { recursive: true });
+fs.writeFileSync(path.join(root, 'evidence/unit.log'), log);
+const outcome = result.status === 0 ? 'passed' : 'failed';
+const checkpoint = { format: 1, scope: 'AC-TITLE unit/HTTP/model verification only. AC-STORE and AC-WEB remain separate checks.',
+  status: 'active', nextAction: mission.nextAction, git: before.git,
+  sources: before.sources.map(({ id, path, sha256 }) => ({ id, path, sha256 })),
+  evidence: [{ id: 'unit', path: 'evidence/unit.log', sha256: digest(log), sourceIds: before.sources.map(s => s.id), dependsOn: [],
+    outcome, criterionIds: ['AC-TITLE'], kind: 'automated', revision: `${before.git.commit}; working-content ${before.git.diffSha256}` }] };
+fs.writeFileSync(path.join(root, 'evidence/context.json'), JSON.stringify(before, null, 2));
+fs.writeFileSync(path.join(root, 'evidence/checkpoint.json'), JSON.stringify(checkpoint, null, 2));
+const report = inspectCheckpoint(root, checkpoint);
+console.log(JSON.stringify({ kind: 'deterministic-fixture', command: 'npm test', outcome, checkpoint: 'examples/fullstack/evidence/checkpoint.json', report,
+  limitation: 'This invocation checks unit/HTTP/model only. Database, production e2e and native host behavior are separate evidence.' }, null, 2));
+if (result.status !== 0 || report.status !== 'ready') process.exitCode = 1;

package/scripts/hosts/checks.mjs

@@ -0,0 +1,13 @@
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { checkPath } from '../../dist/filesystem.js';
+/** macOS-only verified fixture runner. No network or writable filesystem. */
+export function verifyFixture(directory, args) {
+  if (process.platform !== 'darwin') return { status:null, error:new Error('Native verification adapter currently supports macOS only.'),stdout:'',stderr:'' };
+  directory=path.resolve(directory);checkPath(directory);
+  const roots=[directory,path.dirname(process.execPath),'/System','/usr','/bin','/Library','/opt/homebrew','/dev'];
+  const profile=`(version 1) (allow default) (deny network*) (deny file-write*) (deny file-read* (subpath "/Users") (subpath "/private/tmp") (subpath "/private/var/folders")) (allow file-read-metadata) (allow file-read* ${roots.map(p=>`(subpath ${JSON.stringify(p)})`).join(' ')}) (allow file-write* (literal "/dev/null"))`;
+  return spawnSync('/usr/bin/sandbox-exec',['-p',profile,process.execPath,...args],{
+    cwd:directory,env:{PATH:process.env.PATH,LANG:'en_US.UTF-8'},encoding:'utf8',timeout:30000,maxBuffer:1024*1024
+  });
+}

package/scripts/hosts/codex-meter.mjs

@@ -0,0 +1,17 @@
+/** Reconcile a complete private app-server stream; cumulative totals are not deltas. */
+export function meterCodexTree(events, root) {
+  const ids=new Set([root]), totals=new Map(), active=new Map(), ended=new Set();
+  for(const e of events) {
+    const p=e.params ?? {}, item=p.item;
+    if(item?.type==='subAgentActivity' && ids.has(p.threadId)) ids.add(item.agentThreadId);
+    if(e.method==='thread/started' && ids.has(p.thread?.parentThreadId))ids.add(p.thread.id);
+    if(e.method==='thread/tokenUsage/updated')totals.set(p.threadId,p.tokenUsage?.total);
+    if(e.method==='turn/started'){active.set(p.threadId,p.turn.id);ended.delete(p.threadId);}
+    if(e.method==='turn/completed'){active.delete(p.threadId);ended.add(p.threadId);}
+  }
+  const missing=[...ids].filter(id=>!id || !ended.has(id) || active.has(id) || !['inputTokens','outputTokens'].every(k=>Number.isSafeInteger(totals.get(id)?.[k]) && totals.get(id)[k]>=0));
+  // Usage for an undiscovered thread means attribution is incomplete.
+  for(const id of totals.keys())if(!ids.has(id))missing.push(id);
+  const usage=missing.length?null:{inputTokens:[...ids].reduce((n,id)=>n+totals.get(id).inputTokens,0),outputTokens:[...ids].reduce((n,id)=>n+totals.get(id).outputTokens,0),costUSD:null};
+  return {threads:[...ids],missing,usage};
+}

package/scripts/hosts/codex-rpc.mjs

@@ -0,0 +1,44 @@
+import { spawn } from 'node:child_process';
+import { codexEnvironment } from './codex.mjs';
+
+/** Private stdio server, bounded lifetime. Never attaches to the desktop daemon. */
+export function startCodexRpc({ cwd, timeoutMs = 120000, onEvent = () => {}, command = 'codex', args = ['app-server', '--stdio', '--disable', 'apps', '--disable', 'plugins', '--disable', 'remote_plugin'] }) {
+  if (!Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 120000) throw new Error('Invalid RPC lifetime');
+  const child = spawn(command, args,
+    { cwd, env: codexEnvironment(), detached: process.platform !== 'win32', stdio: ['pipe', 'pipe', 'pipe'] });
+  const pending = new Map(); let next = 0, buffer = '', bytes = 0, stopped = false;
+  const kill = () => { try { process.platform === 'win32' ? child.kill('SIGKILL') : process.kill(-child.pid, 'SIGKILL'); } catch {} };
+  function close(error = new Error('RPC server closed')) {
+    if (stopped) return; stopped = true; clearTimeout(timer); process.removeListener('exit',kill); kill();
+    for (const { reject } of pending.values()) reject(error); pending.clear();
+  }
+  process.once('exit',kill);
+  const timer = setTimeout(() => close(new Error('RPC lifetime exceeded')), timeoutMs);
+  function send(message) { if (stopped) throw new Error('RPC closed'); child.stdin.write(JSON.stringify(message)+'\n'); }
+  child.stdout.setEncoding('utf8');
+  child.stdout.on('data', chunk => {
+    bytes += Buffer.byteLength(chunk); if (bytes > 2*1024*1024) return close(new Error('RPC output limit'));
+    buffer += chunk;
+    let end;
+    while ((end = buffer.indexOf('\n')) >= 0) {
+      const line = buffer.slice(0,end); buffer = buffer.slice(end+1); if (!line.trim()) continue;
+      try {
+        const message = JSON.parse(line);
+        if ('id' in message && !message.method) {
+          const call = pending.get(message.id); if (!call) continue; pending.delete(message.id);
+          message.error ? call.reject(new Error(JSON.stringify(message.error))) : call.resolve(message.result);
+        } else if ('id' in message) {
+          // Unattended probes never approve tool execution or fulfill external requests.
+          send({ id: message.id, error: { code: -32601, message: 'Client requests disabled in probe' } });
+        } else onEvent(message);
+      } catch (error) { close(error); }
+    }
+  });
+  child.stderr.on('data', chunk => { bytes += chunk.length; if (bytes > 2*1024*1024) close(new Error('RPC output limit')); });
+  child.on('error', close); child.on('close', () => close()); child.stdin.on('error', close);
+  return { close, notify: send, call(method, params = {}) {
+    if (stopped) return Promise.reject(new Error('RPC closed'));
+    const id = ++next;
+    return new Promise((resolve,reject) => { pending.set(id,{resolve,reject}); send({ id, method, params }); });
+  } };
+}

package/scripts/hosts/codex-task.mjs

@@ -0,0 +1,29 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {startCodexRpc} from './codex-rpc.mjs';
+import {meterCodexTree} from './codex-meter.mjs';
+export async function runCodexTask({cwd,prompt,logFile,rpcFactory=startCodexRpc}) {
+ const events=[],turns=new Map(),drained=[];let root,finish;const done=new Promise(resolve=>{finish=resolve;});
+ const log=fs.openSync(logFile,'wx');
+ const rpc=rpcFactory({cwd,onEvent(e){
+  if(e.method==='account/rateLimits/updated')return;
+  events.push(e);fs.writeSync(log,JSON.stringify(e)+'\n');const p=e.params;
+  if(e.method==='turn/started')turns.set(p.threadId,p.turn.id);
+  if(e.method==='turn/completed'){turns.delete(p.threadId);if(p.threadId===root)finish(p.turn.status);if(!turns.size)drained.splice(0).forEach(resolve=>resolve());}
+ }});
+ let cancelled=false;const cancel=()=>{cancelled=true;finish('cancelled');};process.on('SIGINT',cancel);process.on('SIGTERM',cancel);
+ let status='failed',error,timer;
+ try{
+  await rpc.call('initialize',{clientInfo:{name:'devmethod_comparison',version:'0.1.0'},capabilities:{experimentalApi:true}});if(cancelled){status='cancelled';throw new Error('Cancelled before thread start');}rpc.notify({method:'initialized'});
+  const tmp=path.join(cwd,'.runtime/tmp');fs.mkdirSync(tmp,{recursive:true});
+  const start=await rpc.call('thread/start',{cwd,model:'gpt-5.6-sol',ephemeral:true,approvalPolicy:'never',sandbox:'workspace-write',config:{'model_reasoning_effort':'low','features.multi_agent':true,'agents.max_threads':4,'agents.max_depth':1,'web_search':'disabled','features.apps':false,'features.plugins':false,'features.remote_plugin':false,'sandbox_workspace_write.writable_roots':[cwd,path.join(cwd,'.git')],'sandbox_workspace_write.network_access':false,'sandbox_workspace_write.exclude_tmpdir_env_var':true,'sandbox_workspace_write.exclude_slash_tmp':true,'shell_environment_policy.inherit':'core','shell_environment_policy.set':{TMPDIR:tmp,UV_OFFLINE:'1',UV_PYTHON_DOWNLOADS:'never'}}});root=start.thread.id;if(cancelled){status='cancelled';throw new Error('Cancelled before model dispatch');}
+  await rpc.call('turn/start',{threadId:root,effort:'low',input:[{type:'text',text:prompt,text_elements:[]}]});
+  status=await Promise.race([done,new Promise(resolve=>{timer=setTimeout(()=>resolve('timeout'),110000);})]);
+  if(status==='completed'&&turns.size)status='incomplete';
+  if(status==='timeout'||status==='cancelled'||turns.size){
+   await Promise.allSettled([...turns].map(([threadId,turnId])=>rpc.call('turn/interrupt',{threadId,turnId})));
+   if(turns.size){let drainTimer;try{await Promise.race([new Promise(resolve=>drained.push(resolve)),new Promise(resolve=>{drainTimer=setTimeout(resolve,1500);})]);}finally{clearTimeout(drainTimer);}}
+  }
+ }catch(e){error=e.message;}finally{clearTimeout(timer);process.removeListener('SIGINT',cancel);process.removeListener('SIGTERM',cancel);rpc.close();fs.closeSync(log);}
+ return {status:status==='completed'?'exited':status,root,error,...meterCodexTree(events,root)};
+}

package/scripts/hosts/codex.mjs

@@ -0,0 +1,28 @@
+/** Codex CLI 0.147.0 adapter. Optional tooling, never part of offline init. */
+export const codexVersion = 'codex-cli 0.147.0';
+export function codexArguments({ directory, model }) {
+  if (model !== 'gpt-5.6-sol') throw new Error('This pilot pins gpt-5.6-sol.');
+  return ['exec', '--ignore-user-config', '--ephemeral', '--json', '--color', 'never',
+    '--disable', 'apps', '--disable', 'plugins', '--disable', 'remote_plugin',
+    '--sandbox', 'workspace-write', '-C', directory, '--model', model,
+    '-c', 'model_reasoning_effort="low"', '-c', 'approval_policy="never"',
+    '-c', 'web_search="disabled"', '-c', 'sandbox_workspace_write.network_access=false',
+    '-c', 'sandbox_workspace_write.exclude_tmpdir_env_var=true',
+    '-c', 'sandbox_workspace_write.exclude_slash_tmp=true',
+    '-c', 'features.multi_agent=false', '-c', 'shell_environment_policy.inherit="core"',
+    '-c', 'shell_environment_policy.ignore_default_excludes=false', '-'];
+}
+export function codexUsage(lines) {
+  const turns = lines.filter(e => e.type === 'turn.completed');
+  if (!turns.length) return null;
+  const fields = ['input_tokens', 'output_tokens'];
+  if (turns.some(t => fields.some(k => !Number.isSafeInteger(t.usage?.[k]) || t.usage[k] < 0))) return null;
+  return { inputTokens: turns.reduce((n,t) => n+t.usage.input_tokens,0), outputTokens: turns.reduce((n,t) => n+t.usage.output_tokens,0),
+    cachedInputTokens: turns.every(t => Number.isSafeInteger(t.usage.cached_input_tokens)) ? turns.reduce((n,t) => n+t.usage.cached_input_tokens,0) : null,
+    costUSD: null };
+}
+
+export function codexEnvironment(source = process.env) {
+  const allowed = ['PATH','HOME','USER','LOGNAME','TMPDIR','TEMP','TMP','SystemRoot','SYSTEMROOT','WINDIR','COMSPEC','PATHEXT','LANG','LC_ALL','CODEX_HOME'];
+  return Object.fromEntries(allowed.filter(k => source[k] !== undefined).map(k => [k,source[k]]));
+}

package/scripts/media/demo-actions.cjs

@@ -0,0 +1,16 @@
+const pause=ms=>new Promise(r=>setTimeout(r,ms));
+exports.prepare=async page=>{
+ await page.evaluate(()=>localStorage.clear());await page.reload();
+ await page.locator('#demo-button').click();
+ await page.locator('.workspace').scrollIntoViewIfNeeded();
+};
+exports.perform=async page=>{
+ await pause(1000);
+ await page.locator('#task-title').pressSequentially('Préparer ma prochaine idée',{delay:42});
+ await page.locator('#task-note').fill('Un premier pas concret, aujourd’hui.');
+ await page.locator('.add-button').click();await pause(1000);
+ await page.locator('.task-check').first().click();await pause(850);
+ await page.locator('[data-filter="done"]').click();await pause(1000);
+ await page.locator('[data-filter="all"]').click();await pause(850);
+ await page.reload();await page.locator('.workspace').scrollIntoViewIfNeeded();
+};

package/scripts/media/encode-demo.py

@@ -0,0 +1,22 @@
+"""Encode recorded scenes with French system speech, MP4 subtitles, and an SRT sidecar.
+Requires ffmpeg, ffprobe and macOS say with the Thomas voice. Run after record-demo.cjs.
+"""
+import json, pathlib, subprocess
+root=pathlib.Path('docs/media/from-zero');tmp=pathlib.Path('/private/tmp/devmethod-video');tmp.mkdir(exist_ok=True)
+scenes=json.loads((root/'scenes.json').read_text())
+def run(args): subprocess.run(args,check=True,stdout=subprocess.DEVNULL,stderr=subprocess.PIPE)
+def stamp(t):
+ ms=round(t*1000);return f'{ms//3600000:02}:{ms//60000%60:02}:{ms//1000%60:02},{ms%1000:03}'
+subs=[];elapsed=0
+for i,s in enumerate(scenes):
+ text=tmp/f'{i}.txt';text.write_text(s['voice'])
+ if not (tmp/f'{i}.aiff').exists(): run(['say','-v','Thomas','-r','155','-f',str(text),'-o',str(tmp/f'{i}.aiff')])
+ run(['ffmpeg','-y','-i',str(tmp/f'scene-{i}.webm'),'-i',str(tmp/f'{i}.aiff'),'-vf','fps=30,scale=1280:720,format=yuv420p','-af','apad','-t',str(s['duration']),'-c:v','libx264','-preset','medium','-crf','21','-c:a','aac','-b:a','160k',str(tmp/f'{i}.mp4')])
+ sentences=[v.strip()+'.' for v in s['voice'].split('.') if v.strip()];voice_duration=s['duration']-1.2;cursor=elapsed
+ for sentence in sentences:
+  duration=voice_duration*len(sentence)/sum(map(len,sentences));subs.append(f'{len(subs)+1}\n{stamp(cursor)} --> {stamp(cursor+duration)}\n{sentence}\n');cursor+=duration
+ elapsed+=s['duration']
+(root/'devmethod-demo.fr.srt').write_text('\n'.join(subs))
+(tmp/'concat.txt').write_text(''.join(f"file '{i}.mp4'\n" for i in range(len(scenes))))
+run(['ffmpeg','-y','-f','concat','-safe','0','-i',str(tmp/'concat.txt'),'-i',str(root/'devmethod-demo.fr.srt'),'-map','0:v','-map','0:a','-map','1:0','-c:v','copy','-c:a','copy','-c:s','mov_text','-metadata:s:s:0','language=fra','-movflags','+faststart',str(root/'devmethod-demo.fr.mp4')])
+print(f'Encoded {elapsed:.1f}s video with French narration and subtitles.')

package/scripts/media/record-demo.cjs

@@ -0,0 +1,30 @@
+// Requires Playwright and Chrome; both demo servers must be running on loopback.
+const { chromium } = require(process.env.PLAYWRIGHT_MODULE || 'playwright');
+const fs = require('node:fs');
+const path = require('node:path');
+const root = process.cwd();
+const output = process.env.DEMO_OUTPUT || '/private/tmp/devmethod-video';
+const scenes = JSON.parse(fs.readFileSync('docs/media/from-zero/scenes.json','utf8'));
+const esc = s => s.replaceAll('&','&amp;').replaceAll('<','&lt;').replaceAll('>','&gt;');
+const sleep = ms => new Promise(r=>setTimeout(r,ms));
+function card(s,i){
+ const visual=i===3?`<img class="visual" src="data:image/png;base64,${fs.readFileSync('examples/visual-pilot/directions-v1.png').toString('base64')}" alt="Trois directions du pilote Lisière">`:'';
+ return `<!doctype html><html lang="fr"><meta charset="utf-8"><style>*{box-sizing:border-box}body{margin:0;background:#142c29;color:#fbf5e8;font-family:Arial,sans-serif;width:1280px;height:720px;overflow:hidden}.frame{padding:65px 76px;height:100%;position:relative}.brand{font-size:23px;letter-spacing:2px}.eyebrow{color:#f4b793;letter-spacing:3px;font-size:15px;margin:70px 0 25px}h1{font:normal 74px/1.05 Georgia,serif;letter-spacing:-2px;max-width:920px;margin:0 0 25px}p{font-size:25px;line-height:1.5;white-space:pre-line;max-width:920px;color:#dce5da;margin:0}.line{height:2px;background:#c4633b;width:90px;margin-bottom:26px}.foot{position:absolute;bottom:32px;left:76px;right:76px;display:flex;justify-content:space-between;color:#b5c6bd;font-size:15px}.visual{position:absolute;right:45px;top:150px;width:700px;border-radius:6px}.with-visual h1{font-size:49px;max-width:390px}.with-visual p{font-size:21px;max-width:360px}.with-visual .eyebrow{margin-top:62px}.num{position:absolute;right:72px;top:55px;font:italic 46px Georgia;color:#54736c}</style><div class="frame ${visual?'with-visual':''}"><div class="brand">DevMethod<span class="num">0${i+1}</span></div><div class="eyebrow">${esc(s.eyebrow)}</div><div class="line"></div><h1>${esc(s.title)}</h1><p>${esc(s.text)}</p>${visual}<div class="foot"><span>Du besoin aux preuves.</span><span>Essais réels encadrés · Septembre 2026</span></div></div></html>`;
+}
+(async()=>{
+ fs.mkdirSync(output,{recursive:true});
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ for(let i=0;i<scenes.length;i++){
+  const s=scenes[i];const context=await browser.newContext({viewport:{width:1280,height:720},recordVideo:{dir:output,size:{width:1280,height:720}}});const page=await context.newPage();
+  if(s.kind==='app'){
+   await page.goto('http://127.0.0.1:8766');
+   // Action sequence lives separately, grounded in the finished app's controls.
+   const actions=require(path.join(root,'scripts/media/demo-actions.cjs'));
+   await actions.prepare(page);
+   await page.screenshot({path:path.join(output,`scene-${i}.png`)});
+   const start=Date.now();await actions.perform(page);await sleep(Math.max(0,s.duration*1000-(Date.now()-start)));
+  }else{await page.setContent(card(s,i));await page.screenshot({path:path.join(output,`scene-${i}.png`)});await sleep(s.duration*1000);}
+  const video=page.video();await context.close();fs.copyFileSync(await video.path(),path.join(output,`scene-${i}.webm`));console.log(`Scene ${i+1}/${scenes.length} recorded`);
+ }
+ await browser.close();
+})().catch(e=>{console.error(e);process.exit(1)});

package/scripts/media/visual-short/check.cjs

@@ -0,0 +1 @@
+const fs=require('fs'),assert=require('node:assert/strict');const{chromium}=require(process.env.PLAYWRIGHT_MODULE || 'playwright');const r='/private/tmp/devmethod-shortfilm';(async()=>{const b=await chromium.launch({channel:'chrome',headless:true});const p=await b.newPage({viewport:{width:1440,height:1000}}),errs=[];p.on('pageerror',e=>errs.push(e.message));await p.goto('http://localhost:8768/app/');assert.equal(await p.locator('.book').count(),3);assert.equal(await p.locator('#storage-alert').isVisible(),false);await p.locator('.book').first().getByRole('button',{name:'Marquer terminé'}).click();assert.equal(await p.evaluate(()=>document.activeElement.textContent),'Rouvrir');await p.getByRole('button',{name:'Terminés',exact:true}).click();await p.screenshot({path:r+'/desktop.png'});await p.getByRole('button',{name:'Rouvrir'}).click();assert.equal(await p.locator('#empty').isVisible(),true);await p.getByRole('button',{name:'Tous',exact:true}).click();await p.getByRole('button',{name:/Ajouter un livre/}).click();await p.getByLabel('Titre',{exact:true}).fill('Les heures claires');await p.getByLabel('Auteur',{exact:true}).fill('Camille Laurent');await p.screenshot({path:r+'/modal.png'});await p.getByRole('button',{name:'Ajouter',exact:true}).click();assert.equal(await p.locator('.book').count(),4);await p.reload();assert.equal(await p.locator('.book').count(),4);await p.setViewportSize({width:390,height:844});await p.screenshot({path:r+'/mobile.png',fullPage:true});assert(await p.evaluate(()=>document.documentElement.scrollWidth<=innerWidth));assert.equal(errs.length,0);await p.evaluate(()=>localStorage.setItem('lisiere.books.v1','broken'));await p.reload();assert(await p.locator('#storage-alert').isVisible());await p.locator('.book').first().getByRole('button').click();assert.equal(await p.evaluate(()=>localStorage.getItem('lisiere.books.v1')),'broken');console.log('PASS: initial UI, filter, status/focus, empty state, modal, add, reload, mobile, malformed storage preserved; zero page errors.');await b.close()})();

package/scripts/media/visual-short/encode.py

@@ -0,0 +1,16 @@
+import pathlib,json,subprocess,re
+r=pathlib.Path('/private/tmp/devmethod-shortfilm');o=pathlib.Path('docs/media/visual-chain');s=json.loads((r/'scenes.json').read_text());t=json.loads((r/'times.json').read_text());base=t[0]['start'];total=t[-1]['start']-base
+subs=[];concat=[]
+def run(a):
+ p=subprocess.run(a,stdout=subprocess.DEVNULL,stderr=subprocess.PIPE)
+ if p.returncode:raise RuntimeError(p.stderr.decode()[-1500:])
+def stamp(v):
+ m=round(v*1000);return f'{m//3600000:02}:{m//60000%60:02}:{m//1000%60:02},{m%1000:03}'
+for i,scene in enumerate(s):
+ duration=t[i+1]['start']-t[i]['start'];run(['ffmpeg','-y','-i',str(r/f'audio/{i}.aiff'),'-af','apad','-t',str(duration),'-ar','48000','-c:a','pcm_s16le',str(r/f'audio/{i}.wav')]);concat.append(f"file '{r}/audio/{i}.wav'")
+ parts=re.split(r'(?<=[.!?])\s+',scene['voice']);cursor=t[i]['start']-base;spoken=float(subprocess.check_output(['ffprobe','-v','error','-show_entries','format=duration','-of','csv=p=0',str(r/f'audio/{i}.aiff')]))
+ for part in parts:
+  length=spoken*len(part)/sum(map(len,parts));subs.append(f'{len(subs)+1}\n{stamp(cursor)} --> {stamp(cursor+length)}\n{part}\n');cursor+=length
+(r/'audio-concat.txt').write_text('\n'.join(concat));(o/'devmethod-du-besoin-au-produit.fr.srt').write_text('\n'.join(subs))
+vf=f"[0:v]trim=start={base}:end={t[-1]['start']},setpts=PTS-STARTPTS,fps=25,format=yuv420p[v]"
+run(['ffmpeg','-y','-i',str(r/'film.webm'),'-f','concat','-safe','0','-i',str(r/'audio-concat.txt'),'-i',str(o/'devmethod-du-besoin-au-produit.fr.srt'),'-filter_complex',vf,'-map','[v]','-map','1:a','-map','2:0','-t',str(total),'-c:v','libx264','-threads','4','-preset','veryfast','-crf','20','-c:a','aac','-b:a','192k','-c:s','mov_text','-metadata:s:a:0','language=fra','-metadata:s:s:0','language=fra','-movflags','+faststart',str(o/'devmethod-du-besoin-au-produit-4k.fr.mp4')]);print('FINAL',total,flush=True)

package/scripts/media/visual-short/record.cjs

@@ -0,0 +1,4 @@
+const fs=require('fs');const{chromium}=require(process.env.PLAYWRIGHT_MODULE || 'playwright');const r='/private/tmp/devmethod-shortfilm',repo=process.cwd();const onlyApp=process.argv.includes('--only-app');const scenes=JSON.parse(fs.readFileSync(r+'/scenes.json'));const esc=s=>s.replaceAll('&','&amp;').replaceAll('<','&lt;').replaceAll('>','&gt;');const assetPaths={directions:repo+'/examples/visual-pilot/directions-v1.png',master:repo+'/examples/visual-pilot/editorial-mockup-v1.png',add:repo+'/docs/media/visual-chain/assets/add-book-v1.png',completed:repo+'/docs/media/visual-chain/assets/completed-v1.png',desktop:r+'/desktop.png',mobile:r+'/mobile.png'};const images={};for(const[k,v]of Object.entries(assetPaths))if(fs.existsSync(v))images[k]='data:image/png;base64,'+fs.readFileSync(v).toString('base64');
+const css=`*{box-sizing:border-box}html,body{margin:0;background:#0e1d21;overflow:hidden;color:#f6f0e5;font-family:Arial}.stage{position:relative;width:1920px;height:1080px;transform:scale(2);transform-origin:0 0;overflow:hidden;background:radial-gradient(ellipse at 90% 100%,#25433f,#0e1d21 70%)}header{position:absolute;left:80px;right:80px;top:38px;display:flex;justify-content:space-between;color:#b0c6bf;font-size:20px;letter-spacing:2px}h1{position:absolute;left:80px;top:85px;font:64px/1.05 Georgia;font-weight:400;letter-spacing:-1.5px;margin:0}footer{position:absolute;left:80px;bottom:28px;font-size:16px;color:#a0b8b1}.counter{position:absolute;right:80px;bottom:28px;font-size:17px;color:#a0b8b1}.progress{position:absolute;bottom:0;left:0;height:4px;width:100%;transform:scaleX(0);transform-origin:left;background:#dc9972;animation:progress var(--duration) linear forwards}@keyframes progress{to{transform:scaleX(1)}}.command{background:#183137;border:1px solid #45625f;border-radius:16px;padding:28px;box-shadow:0 20px 60px #0002}.command small{font-size:16px;color:#cfad8d;letter-spacing:2px}.cmd{font:25px/1.45 Menlo,monospace;color:#f1b98e;white-space:pre-wrap;min-height:72px;margin:18px 0}.request{font-size:25px;line-height:1.4;color:#ecf1e8}.side{position:absolute;left:80px;top:250px;width:500px}.out{margin-top:28px;font-size:27px;line-height:1.5;color:#c6d7cc;animation:enter .5s 1.2s both}.visual{position:absolute;left:650px;top:215px;width:1190px;height:780px;display:flex;align-items:center;justify-content:center;overflow:hidden;border-radius:10px}.visual img{width:100%;height:100%;object-fit:contain;animation:enter .6s .7s both,drift var(--duration) ease-in-out both}.full{left:150px;width:1620px}.full img{max-width:1550px}.mobile img{max-width:440px}.choice{position:absolute;right:70px;bottom:30px;background:#a13a20;border:1px solid #ffd3ae;border-radius:12px;padding:18px 26px;font:30px Georgia;animation:enter .5s 1.8s both}.history{position:absolute;left:150px;bottom:82px;font-size:16px;color:#9fbab2}.central{position:absolute;left:210px;top:280px;width:1500px}.central .cmd{font-size:40px}.central .request{font-size:35px}.central .out{font-size:44px}.hero{position:absolute;left:140px;top:310px;font:110px/1.13 Georgia;max-width:1580px}.hero b{font-weight:400;color:#e9ae82}.sub{font:34px/1.6 Arial;color:#b5d0c2;animation:enter .6s 1s both}.mini{position:absolute;width:480px;height:650px;top:310px;background:#233b3b;border-radius:15px;padding:12px;animation:enter .55s both}.mini img{width:100%;height:100%;object-fit:contain}.mini.one{left:130px}.mini.two{left:720px;animation-delay:1.8s}.mini.three{left:1310px;animation-delay:3.5s}.arrow{position:absolute;top:600px;color:#e8a776;font-size:60px}.derivecmd{position:absolute;left:130px;right:130px;top:200px;font:24px Menlo;color:#f1b98e}.pair{position:absolute;top:245px;left:90px;right:90px;display:flex;gap:35px;height:700px}.pair figure{width:50%;margin:0;border-radius:12px;overflow:hidden;background:#213838;padding:15px;animation:enter .7s both}.pair img{width:100%;height:610px;object-fit:contain;animation:drift var(--duration) ease-in-out}.pair figcaption{font-size:23px;padding-top:20px}.pair figure+figure{animation-delay:1s}.options{position:absolute;left:370px;right:370px;bottom:70px;display:flex;justify-content:space-between;gap:20px}.options span{font:25px Georgia;background:#1e393b;padding:16px 30px;border-radius:8px;animation:enter .5s both}.options span:nth-child(2){animation-delay:1.6s}.options span:nth-child(3){animation-delay:3.2s}iframe{position:absolute;left:80px;top:230px;width:1440px;height:1000px;transform:scale(.77);transform-origin:0 0;border:0;border-radius:10px}aside{position:absolute;left:1290px;top:390px;width:510px}aside small{font-size:20px;color:#e6ae82}aside h2{font:57px/1.12 Georgia}aside p{font:27px/1.5 Arial;color:#c0d7c9}#cursor{position:absolute;width:22px;height:22px;border:3px solid #fff;background:#b95829;border-radius:50%;box-shadow:0 1px 10px #0009;z-index:20;transition:left .35s,top .35s;pointer-events:none;left:100px;top:300px}@keyframes enter{from{opacity:0;transform:translateY(24px)}to{opacity:1;transform:translateY(0)}}@keyframes drift{from{scale:.985}to{scale:1.035}}`;
+function content(s,i){let x='';const command=`<div class="command"><small>COMMANDE DANS CODEX</small><div class="cmd" data-type="${esc(s.command)}"></div><div class="request">${esc(s.request)}</div></div>`;if(s.kind==='intro'||s.kind==='end')x=`<div class="hero">${s.kind==='intro'?'Une idée.<br><b>Un design. Un produit.</b>':'Votre projet,<br><b>étape après étape.</b>'}<p class="sub">${s.kind==='intro'?'Cadrage → design → architecture → réalisation → vérification':'github.com/montassarkhalloufi/DevMethod'}</p></div>`;else if(s.kind==='text')x=`<div class="central">${command}<div class="out">${esc(s.output)}</div></div>`;else if(s.kind==='derive')x=`<div class="derivecmd">${esc(s.command)} — ${esc(s.request)}</div><div class="mini one"><img src="${images.master}"></div><span class="arrow" style="left:640px">→</span><div class="mini two"><img src="${images.add}"></div><div class="mini three"><img src="${images.completed}"></div>`;else if(s.kind==='compare')x=`<div class="pair"><figure><img src="${images.completed}"><figcaption>Image dérivée du master</figcaption></figure><figure><img src="${images.desktop}"><figcaption>Écran réalisé et vérifié</figcaption></figure></div>`;else if(s.kind==='app')x='<iframe src="http://localhost:8768/app/"></iframe><aside><small>APPLICATION RÉELLE</small><h2 id="action">Votre bibliothèque</h2><p id="detail">Les contrôles agissent vraiment.</p></aside><div id="cursor"></div>';else x=(s.command?`<div class="side">${command}</div>`:'')+`<div class="visual ${s.command?'':'full'} ${s.asset==='mobile'?'mobile':''}"><img src="${images[s.asset]}">${s.kind==='choice'?'<div class="choice">Choix réel : A ✓</div>':''}</div>`+(s.kind==='options'?'<div class="options"><span>A · Éditorial</span><span>B · Atelier</span><span>C · Botanique</span></div>':'')+(['options','choice'].includes(s.kind)?'<div class="history">Choix conservé de la session préparatoire</div>':'');return`<style>${css}</style><div class="stage" style="--duration:${s.duration}s"><header><span>DevMethod / Lisière</span><span>${String(i+1).padStart(2,'0')} / ${scenes.length}</span></header><h1>${s.title}</h1>${x}<footer>Commandes types · résultats réels · montage accéléré</footer><span class="counter">4K / FR</span><div class="progress"></div></div>`;}
+(async()=>{const b=await chromium.launch({channel:'chrome',headless:true});const c=await b.newContext({viewport:{width:3840,height:2160},recordVideo:{dir:r+'/raw',size:{width:3840,height:2160}}});const begun=Date.now(),p=await c.newPage(),times=[];await p.goto('http://localhost:8768/app/');await p.evaluate(()=>localStorage.removeItem('lisiere.books.v1'));for(let i=0;i<scenes.length;i++){if(onlyApp&&scenes[i].kind!=='app')continue;const s=scenes[i];await p.setContent(content(s,i));const start=Date.now();times.push({i,start:(start-begun)/1000});console.log('scene',i);await p.evaluate(()=>{document.querySelectorAll('[data-type]').forEach(e=>{const t=e.dataset.type;let n=0;const id=setInterval(()=>{e.textContent=t.slice(0,++n);if(n>=t.length)clearInterval(id)},18)})});if(s.kind==='app'){const f=p.frameLocator('iframe');const click=async loc=>{await loc.hover();await p.waitForTimeout(250);await loc.click();};const mark=async(t,d)=>{await p.locator('#action').evaluate((e,v)=>e.textContent=v,t);await p.locator('#detail').evaluate((e,v)=>e.textContent=v,d)};await f.locator('h1').waitFor();await p.locator('#cursor').evaluate(e=>e.remove());await p.frames().find(frame=>frame.url().includes(':8768/app/')).evaluate(()=>{const dot=document.createElement('div');dot.style.cssText='position:fixed;width:18px;height:18px;border:2px solid white;border-radius:50%;background:#b95829;z-index:999999;pointer-events:none;transform:translate(-50%,-50%);display:none';document.body.append(dot);document.addEventListener('pointermove',e=>{dot.style.display='block';dot.style.left=e.clientX+'px';dot.style.top=e.clientY+'px'})});await p.waitForTimeout(1500);await mark('Filtrer','Retrouver les livres à commencer.');await click(f.getByRole('button',{name:'À lire',exact:true}));await p.waitForTimeout(1800);await click(f.getByRole('button',{name:'Tous',exact:true}));await mark('Ajouter','Un vrai formulaire, une nouvelle lecture.');await click(f.getByRole('button',{name:/Ajouter un livre/}).first());await f.getByLabel('Titre',{exact:true}).fill('Les heures claires');await f.getByLabel('Auteur',{exact:true}).fill('Camille Laurent');await p.waitForTimeout(1600);await click(f.getByRole('button',{name:'Ajouter',exact:true}));await mark('Faire évoluer','À lire → En cours → Terminé');await click(f.locator('.book').filter({hasText:'Les heures claires'}).getByRole('button',{name:'Commencer',exact:true}));await p.waitForTimeout(1500);await click(f.locator('.book').filter({hasText:'Les heures claires'}).getByRole('button',{name:'Marquer terminé',exact:true}));await click(f.getByRole('button',{name:'Terminés',exact:true}));await p.waitForTimeout(1500);await mark('Retrouver','Les données restent après rechargement.');await p.locator('iframe').evaluate(e=>e.setAttribute("src",e.getAttribute("src")));await f.locator('h1').waitFor();if(await f.locator('.book').count()!==4||await f.locator('#storage-alert').isVisible())throw Error('Persistence failed in recorded scene');await click(f.getByRole('button',{name:'Terminés',exact:true}));await f.getByRole('heading',{name:'Les heures claires',exact:true}).waitFor();}await p.waitForTimeout(Math.max(0,s.duration*1000-(Date.now()-start)-300));if(['Choisir les technologies','Organiser le code','Relire et corriger'].includes(s.title)||['app','derive','compare'].includes(s.kind))await p.screenshot({path:r+`/qa-${i}.png`});await p.waitForTimeout(Math.max(0,s.duration*1000-(Date.now()-start)));}times.push({i:scenes.length,start:(Date.now()-begun)/1000});const v=p.video();await c.close();fs.copyFileSync(await v.path(),r+(onlyApp?'/app-final.webm':'/film.webm'));fs.writeFileSync(r+(onlyApp?'/app-final-times.json':'/times.json'),JSON.stringify(times));await b.close();})();

package/scripts/media/visual-short/story.py

@@ -0,0 +1,34 @@
+import json,pathlib,subprocess
+r=pathlib.Path('/private/tmp/devmethod-shortfilm');(r/'audio').mkdir(exist_ok=True)
+S=[]
+def add(kind,title,voice,seconds,command='',request='',asset='',output=''):
+ S.append(dict(kind=kind,title=title,voice=voice,duration=seconds,command=command,request=request,asset=asset,output=output))
+add('intro','De l’idée à l’application','Du besoin au design, des choix techniques au produit vérifié. Voici Dev Method sur un projet concret.',6)
+add('text','Décrire le produit','D’abord, décrivez le produit et ce que son utilisateur doit pouvoir faire.',6,'$project-foundation explore','Une bibliothèque personnelle pour suivre mes lectures.',output='Ajouter un livre · Suivre sa lecture · Retrouver ses données')
+add('text','Cadrer une première version','Frame fixe le périmètre : une bibliothèque personnelle, trois statuts, et une sauvegarde sur cet appareil.',7,'$project-foundation frame','Définis une première version utile et ses limites.',output='Ajouter · Filtrer · Changer de statut · Conserver les livres localement')
+add('image','Demander trois directions','Avec design, demandez trois directions pour le même écran.',6,'$project-foundation design','Propose trois directions visuelles comparables.','directions')
+add('options','Comparer, puis choisir','Éditorial, Atelier ou Botanique. Même contenu, trois personnalités visuelles.',6,asset='directions')
+add('choice','Choisir A — Éditorial','Ici, le choix est A. Codex développe cette direction en master screen.',7,'$project-foundation design','Je choisis A. Finalise le master screen.','master')
+add('image','Le master fixe la référence','Le master précise la typographie, les couleurs, les cartes et les boutons. Il est approuvé avant la suite.',8,asset='master')
+add('derive','Décliner le master','La commande suivante reste design : génère les écrans à partir de ce master.',7,'$project-foundation design','Décline ce master : bibliothèque, ajout et lectures terminées.','master')
+add('image','Écran 02 — Ajouter un livre','Voici le formulaire d’ajout, généré avec le master comme référence visuelle.',6,asset='add')
+add('image','Écran 03 — Lectures terminées','Puis la vue des lectures terminées. La même direction accompagne un autre état du produit.',7,asset='completed')
+add('text','Choisir les technologies','Architecture compare les options selon les besoins, le coût et la maintenance. Pour ce petit prototype local, HTML, CSS et JavaScript suffisent.',9,'$project-foundation architecture','Compare les options techniques adaptées à ce périmètre.',output='Prototype retenu : HTML + CSS + JavaScript · Stockage local au navigateur')
+add('text','Organiser le code','Les règles des livres restent séparées de l’interface. Les données sauvegardées sont validées. Une synchronisation entre appareils demanderait une nouvelle décision.',9,'$project-foundation architecture','Définis les responsabilités, les risques et les compromis.',output='Interface ↔ Règles métier ↔ Sauvegarde locale · Limite : un appareil')
+add('text','Préparer la réalisation','Le plan relie ces écrans aux actions à réaliser et aux vérifications attendues.',6,'$project-foundation plan','Prépare une première tranche à partir des écrans.',output='Bibliothèque + filtres → Formulaire → Statuts + sauvegarde')
+add('text','Vérifier que la tranche est prête','Ready vérifie le périmètre, les dépendances et les critères de réussite avant de coder.',6,'$project-foundation ready VISUAL-1','Vérifie que cette tranche est prête.',output='Références disponibles · Interactions définies · Tests attendus')
+add('text','Transformer les images en code','Implement construit l’interface et ses vrais comportements à partir des références.',6,'$project-foundation implement VISUAL-1','Implémente les écrans et leurs interactions.',output='Nouvelle implémentation à partir du master et des images dérivées')
+add('app','L’application fonctionne','Passons au résultat. On filtre la bibliothèque. On ajoute un livre. On commence sa lecture, puis on le marque terminé. Après rechargement, les données sont toujours présentes.',20)
+add('image','Aussi sur mobile','Sur mobile, les mêmes actions restent accessibles dans une disposition adaptée.',6,asset='mobile')
+add('text','Relire et corriger','Review examine le code et les risques. Ici, la revue a conduit à corriger une alerte masquée et le maintien du focus.',8,'$project-foundation review VISUAL-1','Relis la tranche et signale les défauts à corriger.',output='Corrections réelles : affichage de l’alerte · Focus après changement de statut')
+add('text','Vérifier le résultat','Verify contrôle les parcours utiles et les résultats des tests.',6,'$project-foundation verify VISUAL-1','Vérifie les parcours, les erreurs et le rendu.',output='6 tests Node réussis · Parcours Chrome · Sauvegarde · Mobile')
+add('compare','Comparer au design','On compare ensuite le navigateur aux références, puis on corrige les écarts importants.',7,asset='desktop')
+add('text','Livrer une tranche terminée','La livraison locale conserve le résultat et son état de reprise.',6,'$project-foundation integrate VISUAL-1','Consigne la livraison locale et la reprise.',output='Prototype local · Parcours vérifiés · Références conservées')
+add('text','Reprendre sans repartir de zéro','Handoff conserve les décisions, les preuves et les limites. Next retrouve ensuite la suite pertinente, ou constate que le périmètre est terminé.',8,'$project-foundation handoff','Prépare un point de reprise fidèle à la livraison.',output='Décisions + résultat + limites → $project-foundation next')
+add('end','Votre idée. Une chaîne visible.','Découvrez Dev Method sur GitHub et essayez cette chaîne sur votre projet.',6)
+for i,s in enumerate(S):
+ p=r/'audio'/f'{i}.txt';p.write_text(s['voice'].replace('GitHub','guit-hub'))
+ subprocess.run(['say','-v','Thomas','-r','165','-f',str(p),'-o',str(r/'audio'/f'{i}.aiff')],check=True)
+ d=float(subprocess.check_output(['ffprobe','-v','error','-show_entries','format=duration','-of','csv=p=0',str(r/'audio'/f'{i}.aiff')]))
+ s['duration']=max(s['duration'],d+0.7)
+(r/'scenes.json').write_text(json.dumps(S,ensure_ascii=False,indent=2));print('duration',sum(s['duration'] for s in S))