nexus-windows-codex 3.1.1 → 3.1.2

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.1.2] - 2026-10-25 — Docs that match the code
+
+### Fixed
+- The shared action journal recorded version `3.0.0` for every release: the version is now read from `package.json`.
+- The shared policy is looked up in the author's current layout; the embedded `garde-fous.json` stays the copy used by
+  the npm package (no behaviour change for npm installs).
+- SKILL.md and the API reference describe the code as it is: physical fallback by the helper's own real input
+  (`physical:native`) before Sky's, native WebP captures usable as `screenshotId` for a background click or wheel,
+  background keys and Ctrl/Shift shortcuts in Win32 and WinForms, wheel at a point in Win32, WinForms, WPF, Tk and
+  Chromium started with a DevTools port; product name NexusWindows for Codex; installer path neutral.
+- README: the measurements section no longer points to the French-only validation archive.
+
+### Removed
+- `VALIDATION.md` (French archive of the 1.x validations).
+
 ## [3.1.1] - 2026-10-24 — Numbers on the image
 
 ### Added

package/README.md

@@ -335,8 +335,7 @@ test.ps1         offline check; -Full adds the real validation
 
 ## Measurements
 
-From [VALIDATION.md](VALIDATION.md) (October 15, 2026, real validation on the repository's own fixture; the file is in
-French). Windows shown without activation at the bottom of the z-order, the Win32 one covered by the WinForms one.
+Real validation of October 15, 2026 on the repository's own fixture (`tests/live`, run by `test.ps1 -Full`). Windows shown without activation at the bottom of the z-order, the Win32 one covered by the WinForms one.
 Each action: postcondition verified, event counted by the application, foreground unchanged, cursor still.
 
 | Action | Technique | Duration (input and read-backs) |

package/lib/garde-fous.mjs

@@ -5,7 +5,7 @@
 // résilier, passer un dépôt en public) exige `confirm:true` sur l'action, posé seulement sur l'ordre explicite de Julien
 // ou après son oui. Le contrôle porte sur CE QUE LE GESTE DÉCLENCHE, pas sur sa forme : clic par sélecteur ou en
 // coordonnées, Entrée, Ctrl+Entrée, Espace, Alt+lettre, saut de ligne tapé, menu, action secondaire.
-// Fichier lu : NEXUS_GARDE_FOUS s'il est donné, sinon la politique commune de NexusHarness (`../../../shared`), sinon la
+// Fichier lu : NEXUS_GARDE_FOUS s'il est donné, sinon la politique commune de NexusWindows (`../../commun`), sinon la
 // copie embarquée (version publique ; un test vérifie qu'elle est identique). Absent ou invalide : refus (échec fermé).
 import { createHash, randomBytes } from 'node:crypto';
 import { readFileSync, statSync, existsSync } from 'node:fs';
@@ -13,7 +13,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const here = path.dirname(fileURLToPath(import.meta.url));
-export const SHARED_POLICY = path.resolve(here, '..', '..', '..', 'shared', 'garde-fous.json');
+export const SHARED_POLICY = path.resolve(here, '..', '..', 'commun', 'garde-fous.json');
 export const EMBEDDED_POLICY = path.resolve(here, '..', 'garde-fous.json');
 export const AGENT = 'codex';
 const TRIGGER_DEPTH = 8; // ancêtres remontés depuis un texte ou une icône jusqu'à son bouton

package/lib/journal.mjs

@@ -1,11 +1,15 @@
-// Journal commun des trois Nexus Windows (NexusHarness/shared/journal/FORMAT.md) : une ligne par action, sans texte
+// Journal commun des trois Nexus Windows (NexusHarness/NexusShared/journal/FORMAT.md) : une ligne par action, sans texte
 // d'écran (ni texte tapé, ni libellé, ni titre). Écriture synchrone et silencieuse : un journal ne bloque jamais une
 // action, y compris dans un runtime REPL sans objet global `process` (relecture de Codex du 23/10).
-import { appendFileSync, mkdirSync } from 'node:fs';
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
-const VERSION = '3.0.0';
+// Version de l'outil : celle de package.json (jamais écrite en dur, comme stop.mjs).
+const VERSION = (() => {
+  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version ?? 'unknown'; }
+  catch { return 'unknown'; }
+})();
 const ISSUES = {
   verified: '✓', already: '=', 'already-satisfied': '=', observed: '~', 'sent-unconfirmed': '~', unmet: '~',
   unknown: '~', interrupted: '~', refused: 'refus', 'confirmation-required': 'refus', 'julien-active': 'différé',

package/lib/mcp.mjs

@@ -97,7 +97,7 @@ function errorStatus(error) {
 }
 
 // Observation lisible par le modèle : arbre et état, plus l'image native jointe (fichier local, jamais copiée ailleurs).
-// Pas d'image en double (règle commune des produits Nexus, shared/images.md) : mêmes octets (encodeur WebP déterministe :
+// Pas d'image en double (règle commune des produits Nexus, NexusShared/images.md) : mêmes octets (encodeur WebP déterministe :
 // mêmes pixels), mêmes dimensions et même cadre écran que la dernière image envoyée pour cette fenêtre (ou ce zoom) →
 // non jointe, la réponse dit quel identifiant prend les points. `always` (mode image) la joint toujours. `received` :
 // appelé pour chaque image que le modèle a réellement (jointe, ou identique à la dernière envoyée), jamais pour une

package/lib/session.mjs

@@ -557,7 +557,7 @@ export class WindowsSession {
     if (!sameWindow(current, this.#window)) throw new Error('Window identity changed; bind it again');
     const useNative = nativeOnly || backend === 'native' || (backend === 'auto' && this.#nativePreferred);
     // Capture propre (PrintWindow, fenêtre recouverte, sans premier plan) ; image vide ou échec : capture Sky.
-    // Numéros [N] (shared/images.md point 5, avis de Codex du 24/10) : arbre natif lu AVANT la capture, une seule fois et
+    // Numéros [N] (NexusShared/images.md point 5, avis de Codex du 24/10) : arbre natif lu AVANT la capture, une seule fois et
     // sous le même verrou ; ses index et rectangles vont au helper, qui ne les dessine que si le cadre de la fenêtre est
     // resté celui de la lecture. L'âge de l'observation part du début de cette lecture (FRESH_MS).
     let marksNote = null, preread = null, treeStartedAt = null, candidates = null;
@@ -1484,7 +1484,7 @@ export class WindowsSession {
   }
   #record(kind, status, durationMs, technique = null, foreground = null) {
     this.#metrics.push({ kind, status, technique, durationMs, at: new Date().toISOString() });
-    // Journal commun des trois Nexus Windows (shared/journal/FORMAT.md) : sans texte d'écran, jamais bloquant.
+    // Journal commun des trois Nexus Windows (NexusShared/journal/FORMAT.md) : sans texte d'écran, jamais bloquant.
     try { writeJournal(journalLine({ session: this.#sessionId, app: this.#window?.app, kind, status, technique, durationMs, foreground })); }
     catch { /* journal : jamais bloquant */ }
   }

package/lib/tree.mjs

@@ -20,7 +20,7 @@ const stateFlags = new Set(['disabled', 'selected', 'unselected', 'selectable',
   'settable', 'string', 'float', 'integer', 'boolean']);
 export const digest = value => createHash('sha256').update(value).digest('hex');
 
-// Numéros [N] sur l'image (shared/images.md point 5) : éléments natifs avec un rectangle, hors racine et hors éléments
+// Numéros [N] sur l'image (NexusShared/images.md point 5) : éléments natifs avec un rectangle, hors racine et hors éléments
 // dits hors écran. auto : contrôles sans nom (espaces compris) qu'on peut viser ; all : tous. scope : HWND porteur le plus
 // proche (l'élément ou un ancêtre), que le helper compare à la fenêtre capturée (menu surgissant d'une autre fenêtre :
 // jamais d'étiquette fantôme). Index EXACT de la ligne de l'arbre, jamais renuméroté.

package/native/bin/NexusCodex.UIA.exe

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/native/bin/NexusCodex.UIA.exe
 size: 35244346 bytes
-sha256: e348309a77c415cd4e4102bb6f20045b413589c79a48d815560ba99d67273a68
+sha256: 15e9d75e1756c8b0bb63c0bdaad3ee5e18aa1c5a09ab6047686b7326716c44b2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-windows-codex",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "NexusWindows for Codex: Windows computer use in the background for OpenAI Codex (MCP server and Codex skill).",
   "type": "module",
   "license": "MIT",